Function Function Run1LPFCommand( sInput$ ) As Long
Purpose: Run OneLiner command: Relay | Check relay settings.
Works in: OneLiner.
Parameters:
sInput [in] XML string, or full path name to XML file, containing XML node as described in Remarks section below.
Return value:
1 Success
0 Failure
Remarks: sInput must include XML node CHECKRELAYSETTINGS with attributes in the list below (* denotes required entries, [] denotes default value).
REPORTPATHNAME (*) Full pathname of folder for report files.
REPORTCOMMENT Additional comment string to include in all checking report files
SELECTEDOBJ Check line with selected relaygroup. Must have one of following values
“PICKED “ the highlighted relaygroup on the 1-line diagram
“BNO1;'BNAME1';KV1;BNO2;'BNAME2';KV2;'CKT';BTYP;” location string of the relaygroup. Format description is in OneLiner help section 10.2.
TIERS [0] Number of tiers around selected object. This attribute is ignored if SELECTEDOBJ is not found.
AREAS [0-9999] Comma delimited list of area numbers and ranges.
ZONES [0-9999] Comma delimited list of zone numbers and ranges. This attribute is ignored if AREAS is found.
KVS [0-999] Comma delimited list of KV levels and ranges. This attribute is ignored if SELECTEDOBJ attribute is present.
TAGS Comma delimited list of tags. This attribute is ignored if SELECTEDOBJ attribute is present.
DEVICETYPE Space delimited list of relay type types to take into consideration in stepped-events: OCG, OCP, DSG, DSP
FAULTTYPE Space delimited list of fault types to take into consideration in stepped-events: 1LF, 3LG
OUTAGELINES Run line outage contingency: 0-False; 1-True
OUTAGEXFMRS Run transformer outage contingency: 0-False; 1-True
OUTAGEMULINES Run mutual line outage contingency: 0-False; 1-True. Ignored if OUTAGEMULINES=0
OUTAGEMULINESGND Run mutual line outage and grounded contingency: 0-False; 1-True. Ignored if OUTAGEMULINES=0
OUTAGE2LINES Run double line outage contingency: 0-False; 1-True. Ignored if OUTAGEMULINES=0
OUTAGE1LINE1XFMR Run double line and transformer outage contingency: 0-False; 1-True. Ignored if OUTAGEMULINES=0 or OUTAGEXFMRS =0
OUTAGE2XFMRS Run double and transformer outage contingency: 0-False; 1-True. Ignored if OUTAGEXFMRS =0
OUTAGE3SOURCES Outage only 3 strongest sources: 0-False; 1-True. Ignored if OUTAGEMULINES=0 and OUTAGEXFMRS =0
Example:
Sub main
sInput$ = "<CHECKRELAYOPERATIONSEA " & _
"REPORTPATHNAME=""c:\000tmp\"" " & _
"SELECTEDOBJ=""6; 'NEVADA'; 132.; 8; 'REUSENS'; 132.; '1'; 1;"" " & _
" />"
If Run1LPFCommand( sInput ) Then Print "Success" Else Print ErrorString()
End Sub