System Software Library NonStop NET/MASTER MS Command Reference Summary Abstract This reference summary documents the syntax of NonStop NET/MASTER Management Services (MS) commands. This manual is intended for all NonStop NET/MASTER users. Part Number 115413 Edition Second Published Product Version Release ID Supported Releases July 1995 NonStop NET/MASTER D30 D30.02 This manual supports D30.00 and all subsequent releases until otherwise indicated in a new edition.
Document History Edition Part Number Product Version Earliest Supported Release Published First Second 106158 115413 D30 D30 D30.00 D30.02 December 1994 July 1995 New editions incorporate any updates issued since the previous edition. A plus sign (+) after a release ID indicates that this manual describes function added to the base release, either by an interim product modification (IPM) or by a new product version on a .99 site update tape (SUT).
Contents Notation Conventions ix NonStop NET/MASTER MS Commands ! 11 ? 11 AT 11 AUTOHOLD CANCEL 11 CLEAR 11 CLOSTERM CNM 11 12 12 CS- 12 CS+ 12 DEBUG BREAKPOINT DEBUG CLEAR 12 13 DEBUG DISPLAY DEBUG HOLD 13 13 DEBUG LIST BREAKPOINTS DEBUG LOAD DEBUG LOG 13 13 DEBUG MODIFY 14 DEBUG NOLOG 14 DEBUG RESUME DEBUG SET 14 14 DEBUG SOURCE DEBUG START 14 15 DEBUG STEP 15 DEBUG STOP 15 DEBUG TRACE EDIT 15 15 EMSCOLL EMSDIST ENTER 13 15 15 16 115413 Tandem Computers Inco
Contents EQUATE EVERY EXEC 16 16 16 FC 16 FK 17 FLUSH 17 FSTOP 17 GO 18 HISTORY 18 HLPMAINT INTQ ISR K 18 18 18 19 LBANNER 19 LINK DEFINE 19 LINK DELETE 19 LINK RESET 19 LINK START 19 LINK STOP LIST 20 LOG 20 LOGSWAP LTITLE 20 20 20 MAXUSERS MSG 20 20 NCLCHECK NCLCOMP 20 21 NCLQUEUE RESET NCLQUEUE SET NRDRET OCSID 21 21 21 OPENTERM iv 21 21 115413 Tandem Computers Incorporated
Contents OPSYS 22 Format 1 Format 2 ORDER PAGE 25 25 PARAM PF 22 22 25 26 PROCESS ALTER 27 PROCESS SWITCH PROFILE 27 27 PROGRUN 28 Format 1 28 Format 2 28 PSNDCTL process-spec PSNDCTL CLOSE 28 PSNDCTL OPEN 29 PSNDCTL STOP PURGE 29 REQMS 29 RETURN ROUTE 28 29 29 30 SESSION DEFINE 30 SESSION DELETE 30 SHOW COMMANDS 30 SHOW CPUWEIGHT 30 SHOW DOMAINS SHOW ENGINE 30 30 SHOW EQUATES 31 SHOW FILEINFO 31 SHOW FILES 31 SHOW FILTERS SHOW ISR 31 31 SHOW LINKS SHOW LOCKS 32 3
Contents SHOW LOGS 32 SHOW MAPS 32 SHOW NCL 32 SHOW NCLGLBL 33 SHOW NCLOBJECT 33 SHOW NCLQUEUE 33 SHOW NCLSTAT SHOW NRD 33 SHOW OCS 33 33 SHOW PANELS 33 SHOW PARAM 34 SHOW PAUSE 34 SHOW PNLOBJECT SHOW PRELOAD SHOW PROCESS SHOW PSND 34 34 34 34 SHOW PSNDUSER SHOW SESS 35 35 SHOW SYSPARMS SHOW TERM 35 SHOW TERMDEF SHOW TIMER 35 SHOW TRACE 35 SHOW UDB 35 36 SHOW UDBUSER SHOW USERS 35 36 36 SHOW VARTABLES SHUTDOWN 36 36 SHUTDOWN $ABEND$ SIGNOFF link-name SIGNON vi
Contents START 37 STATUS 37 SUBMIT 38 SWAP 38 SYSPARMS 38 TERMINAL ADD 40 TERMINAL DELETE TERMINAL LOCK TIME 41 TITLE 41 41 TRACE trace-spec 42 TRACE ALTER 42 TRACE RESET 42 TRACE START 43 TRACE STOP 43 UDBCTL file-spec 43 UDBCTL CLOSE 43 UDBCTL OPEN 43 UDBCTL RESET 44 UDBCTL STOP 44 UNIT DEFINE 44 UNIT DELETE 44 X 40 44 115413 Tandem Computers Incorporated vii
Contents (This page left intentionally blank) viii 115413 Tandem Computers Incorporated
Notation Conventions General Syntax Notation UPPERCASE LETTERS The following summarizes the notation conventions for syntax presentation in this manual. Uppercase letters indicate keywords and reserved words; enter these items exactly as shown. Items not enclosed in brackets are required. For example: MAXATTACH lowercase italic letters Lowercase italic letters indicate variable items that you supply. Items not enclosed in brackets are required.
Notation Conventions General Syntax Notation Underline _ An underlined syntax item in a horizontal or vertical list is the default value. If you do not choose any item in a list, the default value is used. For example: NONE RED Ellipsis ... BLUE TURQUOISE GREEN WHITE PINK YELLOW An ellipsis immediately following a pair of brackets or braces indicates that you can repeat the enclosed sequence of syntax items any number of times. For example: M address-1 [ , new-value ]... [ - ] {0|1|2|3|4|5|6|7|8|9}..
NonStop NET/MASTER MS Commands ! The ! command immediately executes a previously executed command, without modifications. ! [ number | text ] ? The ? command displays a previously executed command in the roll-delete message display area of an OCS window. ? [ number | text ] AT The AT command issues a command, a message, or a series of commands at a specified time of day.
NonStop NET/MASTER MS Commands CLOSTERM The CLOSTERM command closes the specified terminal(s) from use with NonStop NET/MASTER MS. CLOSTERM [ device-name | logical-name | ALL ] CNM The CNM command establishes and discontinues communication from NonStop NET/MASTER MS (as a communication network management (CNM) application) with the SNAX System Services Control Point (SSCP).
NonStop NET/MASTER MS Commands DEBUG CLEAR The DEBUG CLEAR command clears one or more breakpoint(s) associated with an NCL process. DEBUG CLEAR [ ID=ncl-id ] clear-spec clear-spec: BREAKPOINT=ALL BREAKPOINT=bp-number [ [ BREAKPOINT=bp-number ] … ] DEBUG DISPLAY The DEBUG DISPLAY command displays information about one or more variables in the currently active set of variables.
NonStop NET/MASTER MS Commands DEBUG MODIFY The DEBUG MODIFY command modifies the value of a variable in an NCL process. DEBUG MODIFY [ ID=ncl-id ] [ FORMAT={ NORMAL | BINARY } ] [ SCOPE={ 0 | nesting-level } ] { VAR | VBL }=variable-name VAL[ =value ] DEBUG NOLOG The DEBUG NOLOG command stops the writing of debug messages to the activity log for the specified NCL process(es).
NonStop NET/MASTER MS Commands DEBUG START The DEBUG START command starts a single debug session. DEBUG START [ ID=ncl-id | [ ENV={ ALL | CURRENT | DEPENDENT } ] [ PROCS={ ALLPROCS | CURRPROCS | NEWPROCS } ] [ TERM={ device-name | logical-name } ] [ USER=user-id ] [ WINDOW=window-number ] ] DEBUG STEP The DEBUG STEP command resumes execution of the specified NCL process by single or multiple statements.
NonStop NET/MASTER MS Commands ENTER The ENTER command defines the ENTER key. ENTER [ key-type ] key-type: text IMM PREF,text RESET CONV,text IMM,text SUFF,text EQUATE The EQUATE command assigns a text value to a symbol. EQUATE symbol [ text-value ] EVERY The EVERY command issues a command, a message, or a series of commands at a specified time frequency.
NonStop NET/MASTER MS Commands FK The FK command defines function keys for both Tandem 6530 or compatible terminals and IBM 3270 or compatible terminals, and displays function key definitions.
NonStop NET/MASTER MS Commands GO The GO command resumes execution of a paused NCL process, suspended using either the NCL PAUSE or DELAY verb. GO [ ID=ncl-id ] [ parameter … ] HISTORY The HISTORY command displays the most recently executed command lines. HISTORY [ number ] HLPMAINT The HLPMAINT command transfers command help information between the NonStop NET/MASTER MS command help database and an edit file.
NonStop NET/MASTER MS Commands K The K command clears roll-delete messages in the current OCS window. This command is synonymous with the CLEAR command. K [ ALL | RESP ] LBANNER The LBANNER command sets or erases a NonStop NET/MASTER MS logon screen banner line. LBANNER number LINK DEFINE [ "banner-text" ] The LINK DEFINE command defines an Inter-NET/MASTER Connection (INMC) link definition record and stores it in global memory.
NonStop NET/MASTER MS Commands LINK STOP The LINK STOP command stops an Inter-NET/MASTER Connection (INMC) link. LINK STOP=link-name LIST The LIST command lists the contents of a file: usually, an NCL procedure. LIST file-name [ ID=ncl-procedure-library ] ncl-procedure-library: [ \sys. ][ $volume. ]subvolume LOG The LOG command logs a message to the NonStop NET/MASTER MS activity log.
NonStop NET/MASTER MS Commands NCLCOMP The NCLCOMP command either compiles an NCL procedure or panel description file and writes the object to an object file, or deletes an object from an object file. NCLCOMP { FILE=file-spec1 | PANEL={ panel-desc-file | file-spec1 } | PROC=ncl-procedure } OBJECT=file-spec2 [ DELETE | NOCHECK ] file-spec1: [ \sys. ]$volume.subvolume.file-name file-spec2: [ [ \sys. ] $volume.subvolume. ]file-name NCLQUEUE RESET The NCLQUEUE RESET command deletes an NCL queue.
NonStop NET/MASTER MS Commands OPSYS The OPSYS command submits a Distributed Systems Network Management (DSNM) command for execution. There are two formats of the OPSYS command. Format 1 Format 1 allows you to start, interactively communicate with, and terminate Guardian utilities and to run TACL macros defined in User ID Management Services (UMS).
NonStop NET/MASTER MS Commands The KILL command immediately terminates a utility session. KILL session The SEND command establishes a new utility session with a utility and sends text to it, or sends text to an existing utility session. [ SEND ] session[=utility ] [ text ] The ABORT command causes DSNM to issue the subsystem-specific command(s) that stops each object. ABORT objectspec [, [, [, [, objectspec ]...
NonStop NET/MASTER MS Commands The INQUIRE command obtains the current status of objects as recorded in the DSNM object database. INQUIRE objectspec [, [, [, [, [, [, [, objectspec ]... hierarchy-modifier ] error-modifier ] state-modifier ] response-modifier ] highlight-modifier ] FROM-DISPLAY ] The START command causes DSNM to issue the subsystem-specific command(s) that change each object to the subsystem state that corresponds to the DSNM UP state. START objectspec [, [, [, [, objectspec ]...
NonStop NET/MASTER MS Commands The UPDATE command modifies object attributes in the DSNM object database. UPDATE objectspec [, [, [, [, [, [, [, [, ORDER objectspec ]... hierarchy-modifier ] error-modifier ] state-modifier ] highlight-modifier ] MONITOR | NOMONITOR] ACCEPT [UP] [DOWN] [PENDING] ] FROM-DISPLAY ] The ORDER command displays messages in chronological order on an OCS window. ORDER PAGE The PAGE command clears roll-delete messages in the current OCS window.
NonStop NET/MASTER MS Commands NCLDISTOBJ=file-name NCLDISTSRC=subvolume NCLOBJLIB=subvolume NCLQUEUESVOL=subvolume PNLCUSTSRC=subvolume PNLDISTSRC=subvolume PNLDISTCODE=file-name PROCESSCHAR=process-character PROCESSCLASS={ BK | EM | IS | MS | NC } PROCESSCPU=( cpu1, cpu2 ) PROCESSDEBUGTERM={ device-name | NONE } PROCESSLIBRARY={ file-name | NONE } PROCESSNAME=process-name PROCESSOBJECT=file-name PROCESSPARAM=“startup-string” PROCESSPRIORITY=process-priority PROCESSSWAPVOL=volume PROCESSWEIGHT=process-wei
NonStop NET/MASTER MS Commands PROCESS ALTER The PROCESS ALTER command changes the configuration of a process in the NonStop NET/MASTER MS processing environment. PROCESS ALTER=process-name { BACKUPCPU=bcpu [ DEFER={ YES | NO } ] | CPU=( cpu1, cpu2 ) | WEIGHT=process-weight } PROCESS SWITCH The PROCESS SWITCH command reverses the roles of the primary and backup processes of a NonStop NET/MASTER MS process pair.
NonStop NET/MASTER MS Commands PROGRUN The PROGRUN command suspends your current activity with NonStop NET/MASTER MS and executes an external program, such as a Guardian utility. There are two formats of the PROGRUN command. Format 1 Format 1 allows you to communicate interactively with Guardian utilities defined in User ID Management Services (UMS). PROGRUN utility Format 2 Format 2 allows you to execute any object file, including Guardian utilities.
NonStop NET/MASTER MS Commands PSNDCTL OPEN The PSNDCTL OPEN command makes a Pathway server class available for use by NonStop NET/MASTER MS. PSNDCTL OPEN=process-spec [ ID=server-class-identifier ] [ RECSIZE=buffer-size ] [ SWGUID={ YES | NO } ] process-spec: [ \sys. ]pathmon-process-name.pathway-server-class-name PSNDCTL STOP The PSNDCTL STOP command disassociates a Pathway server class identifier from a Pathway server class.
NonStop NET/MASTER MS Commands ROUTE The ROUTE command sends a command string to a remote NonStop NET/MASTER MS or SOLVE management services system for execution. ROUTE link-name command-string SESSION DEFINE The SESSION DEFINE command defines an Inter-NET/MASTER Connection (INMC) session definition record and stores it in global memory.
NonStop NET/MASTER MS Commands SHOW EQUATES The SHOW EQUATES command displays information about all available global and local equates. SHOW EQUATES SHOW FILEINFO The SHOW FILEINFO command displays information about one or more disk files. SHOW FILEINFO[ =file-spec ] file-spec: file-name $volume.subvolume.file-name \sys.$volume.subvolume.file-name SHOW FILES The SHOW FILES command displays information about the physical attributes of user databases (UDBs). SHOW FILES[ =file-spec ] file-spec: [ \sys.
NonStop NET/MASTER MS Commands SHOW LINKS The SHOW LINKS command displays information about Inter-NET/MASTER Connection (INMC) links. SHOW LINKS[ ={ link-name | ALL | * } ] SHOW LOCKS The SHOW LOCKS command displays the current status of resource locks. SHOW LOCKS [ lock-option ] lock-option: [ CLASS={ ALL | NCL | SYS } ] [ LIST={ ALL | WAIT } ] [ PNAME=primary-name ] [ MNAME=minor-name ] [ TEXT=text ] SHOW LOGS The SHOW LOGS command displays the current status of the activity log files.
NonStop NET/MASTER MS Commands SHOW NCLGLBL The SHOW NCLGLBL command displays the names and information about the contents of NCL global variables. SHOW NCLGLBL[ =global-variable-name ] SHOW NCLOBJECT The SHOW NCLOBJECT command displays information about object images in a particular NCL object file. SHOW NCLOBJECT=file-name [ PROC=ncl-procedure ] file-name: [ \sys. ]$volume.subvolume.file-name SHOW NCLQUEUE The SHOW NCLQUEUE command displays the current execution limit for each NCL queue.
NonStop NET/MASTER MS Commands SHOW PARAM The SHOW PARAM command displays a summary of NonStop NET/MASTER MS startup parameters. SHOW PARAM SHOW PAUSE The SHOW PAUSE command displays information about paused NCL processes. SHOW PAUSE pause-option [ PROC=ncl-procedure ] pause-option: =ENV =REGION =ALL =user-id =device-name =logical-name ID=ncl-id SHOW PNLOBJECT The SHOW PNLOBJECT command displays information about objects in a panel object file.
NonStop NET/MASTER MS Commands SHOW PSNDUSER The SHOW PSNDUSER command displays information about the users and NCL processes currently using Pathway server classes that are available for use by NonStop NET/MASTER MS. SHOW PSNDUSER SHOW SESS The SHOW SESS command displays information about terminals connected to NonStop NET/MASTER MS. This command is synonymous with the SHOW TERM command.
NonStop NET/MASTER MS Commands SHOW UDB The SHOW UDB command displays the status of user databases (UDBs). SHOW UDB[ =file-spec ] file-spec: [ \sys. ][ $volume. ][ subvolume. ]file-name SHOW UDBUSER The SHOW UDBUSER command displays information about the users and NCL processes that are currently using user databases (UDBs). SHOW UDBUSER SHOW USERS The SHOW USERS command displays information about users who are currently logged on to NonStop NET/MASTER MS.
NonStop NET/MASTER MS Commands SIGNOFF link-name The SIGNOFF link-name command logs off a user from a remote NonStop NET/MASTER MS or SOLVE management services system. SIGNOFF link-name SIGNON The SIGNON command refreshes the NonStop NET/MASTER MS security profile of a user. SIGNON SIGNON link-name The SIGNON link-name command logs on a user to a remote NonStop NET/MASTER MS or SOLVE management services system.
NonStop NET/MASTER MS Commands SUBMIT The SUBMIT command submits a command to a virtual user for execution. SUBMIT { BLOG | BMON | BSYS | EMSP | LOGP } command-text SWAP The SWAP command reverses the dimensions of the current logical windows. SWAP [ PSKIP=menu-option ] SYSPARMS The SYSPARMS command defines and changes NonStop NET/MASTER MS system parameters.
NonStop NET/MASTER MS Commands LASTLOGON={ YES | NO } LMSGWARN=repeat-frequency LNKTRACE={ YES | NO } LOCKMAX=maximum-lock-requests LOGFILEn=file-name LOGHIWATER=number LOGLOWATER=number LOGPRCNUM=number-of-log-procedures LOGPROC={ ncl-procedure | FLUSH } LOGWRAP={ YES | NO } MAPDEL=map-name MAPLOAD=map-name MAXPANEL=maximum-panel-queue-size MODLUSER={ model-user-id | NONE } NCLGBTRC=[ global-variable-name ] NCLMAXK=maximum-ncl-storage NCLOBJPATH=( file-name[, file-name ] … ) NCLOGTRM={ YES | NO } NCLPEND=
NonStop NET/MASTER MS Commands SPOUTLOC=color-option SPSUBTLC=color-option SPTITLEC=color-option SPTITLEP=pad-char SWGUIDDSNM={ YES | NO } SYSUDB={ YES | NO } TCMDMAX=maximum-concurrent-timer-commands TEDITOBJ=tedit-file-name TOACT1={ timeout-actn-1 | ( timeout-actn-1,rpt-interval ) } TOACT2={ timeout-actn-2 | ( timeout-actn-2,rpt-interval ) } TOALARM=alarm-limit TOSTART={ INPUT | KBUNL | NONE | OUTPUT | TIO } TOTIME1=timeout-interval-1 TOTIME2=timeout-interval-2 TRACEFILE=file-name TRACEFLAGS=number UNLOA
NonStop NET/MASTER MS Commands TERMINAL LOCK The TERMINAL LOCK command locks the terminal from which the command is issued. TERMINAL LOCK TIME The TIME command displays the current time and date. TIME TITLE The TITLE command sets or erases the title displayed at the top line of all Operator Control Services (OCS) windows; that is, the windows of all users using NonStop NET/MASTER MS.
NonStop NET/MASTER MS Commands TRACE trace-spec The TRACE trace-spec command specifies trace parameter settings, which determine the events that are traced by NonStop NET/MASTER MS.
NonStop NET/MASTER MS Commands TRACE START The TRACE START command starts tracing the specified trace parameter settings— either messages or internal trace points. TRACE START[ [ [ [ =file-name ] COUNT=record-limit ] PAGES=pages ] WRAP={ YES | NO } ] TRACE STOP The TRACE STOP command stops tracing for the specified trace ID. TRACE STOP=trace-id UDBCTL file-spec The UDBCTL file-spec command associates a user database (UDB) identifier with a file name or a pair of file names.
NonStop NET/MASTER MS Commands UDBCTL RESET The UDBCTL RESET command performs a Guardian PURGEDATA operation on a file. UDBCTL RESET=file-spec file-spec: [ \sys. ][ $volume. ][ subvolume. ]file-name UDBCTL STOP The UDBCTL STOP command disassociates a user database (UDB) identifier from a UDB or UDB pair. UDBCTL STOP=udb-id UNIT DEFINE The UNIT DEFINE command defines an Inter-NET/MASTER Connection (INMC) unit definition record and stores it in global memory.