Display information on operator commands
Component: | BS2000 |
Functional area: | Operator terminal control |
Domain: | CONSOLE-MANAGEMENT |
Privileges: | OPERATING |
Routing code: | @ |
Function
This command provides the operator with an overview of the authorization and type of the operator commands.
The CMD-NAME and SELECT operands are used to select the commands to be queried. The INFORMATION operand controls the scope of the information to be output.
Restriction
The command can be entered only at logical or physical operator terminals (consoles). It must not be issued from a user task with the OPERATING privilege.
Format
SHOW-CMD-ATTRIBUTES | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
CMD-NAME =
Specifies the command name for which an entry in the command table is to be displayed.
CMD-NAME = *ALL
All operator commands are to be displayed.
If SHOW-CMD-ATTRIBUTES CMD-NAME=*ALL is entered, the command output is sorted, with identical commands grouped together. The first command listed (in the previously valid format) is the primary command, which is fully abbreviable. This is usually the longest of the identical commands (current exception: SET/RESET/SHOW-MSG-SUPPRESSION).
Then the aliases of the given command are listed. They are marked as aliases by being indented by one column in the associated output line. These aliases cannot be abbreviated.
CMD-NAME = <structured-name 1..30>
Specifies the name of the command for which the entry in the command table is to be displayed. The command name can be up to 30 characters long and must comply with the naming convention for command names.
SELECT =
Selects the information.
SELECT = *ALL
All command names are to be output.
SELECT = *EXTERNAL-SERVER(...)
Specifies that information on special operator commands is to be displayed. Special operator commands are commands that are executed in $CONSOLE applications (authorized user programs).
APPLICATION-NAME =
Specifies the names of the $CONSOLE applications.
APPLICATION-NAME = *ALL
Information on all special operator commands is requested.
APPLICATION-NAME = *OWN
Information is listed on all special operator commands for which the command issuer is also the command processor. The scope of the information is defined in the INFORMATION operand. In this form, the command can only be issued from $CONSOLE applications.
APPLICATION-NAME = <alphanum-name 4..4>
Lists the set of special operator commands for which the specified $CONSOLE application acts as command processor.
SELECT = *INTERNAL-SERVER(...)
The information should relate to standard operator commands.
These commands are executed in system components.
ENTRY =
Selects the commands via the call interface.
ENTRY = *ALL
Selects all call interfaces.
ENTRY = *NONE
Selects all standard operator commands for which there are no entries in the command table relating to the call interface.
ENTRY = *ENTRY-NAME(...)
Selects standard operator commands whose call interface is entered by name.
ENTRY-NAME = *ALL
Displays all the commands whose call interface is entered by name in the table.
ENTRY-NAME = <name 1..8>
Name of the call interface which the command uses.
ENTRY = *ENTRY-ADDRESS(...)
Selects the standard operator commands whose call interface is entered via the address.
ENTRY-ADDRESS = *ALL
Displays all commands for which the address of their call interface is entered into the table.
ENTRY-ADDRESS = <x-string 1..8>
Address of the call interface which the command uses.
SELECT = *AUTHORIZATION-CODE(...)
The commands that are to be displayed are to be selected on the basis of the routing code (authorization code) needed to be able to issue them at an operator terminal.
AUTHORIZATION-CODE =
Commands are selected by routing code.
AUTHORIZATION-CODE = *ALL
All commands which are protected by any routing code are to be displayed.
AUTHORIZATION-CODE = <alphanum-name 1..1> / *
All the commands protected by the specified routing code (one of the characters A..Z, 0..9, #, @ and *) are to be displayed.
INFORMATION =
Defines the scope of the information to be output on the selected command.
INFORMATION = *MINIMUM
For each selected command, the command name and routing code required for its use are output.
INFORMATION = *MEDIUM
As for INFORMATION=*MAXIMUM, all available information is displayed (see below).
The only difference between *MEDIUM and *MAXIMUM is that *MEDIUM outputs the current values and *MAXIMUM also outputs the “inactive” table entries. Normally, where the command is entered just once in the table, the output of *MEDIUM and *MAXIMUM is identical; you have multiple table entries for the following cases only:
multiple command name logon (see CONNECT-CMD-SERVER)
for “safe” system commands for which all the four maximum table entries possible are occupied to prevent anyone else logging on for the command.
INFORMATION = *MAXIMUM
All available information is displayed for each selected command.
The following information is output:
the command name
the authorization lock of the command
the command type (INTERNAL = command execution in system components EXTERNAL = command execution in authorized user programs)
the call interface (D=direct, S=SDF, $=$CONSOLE)
the communication interval limit (unit = n seconds)
The specified number multiplied by n (the unit n is governed by the class 2 system parameter NBRCILU) gives the time that may elapse during command processing before the next command waiting for execution is started.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
2 | 0 | NBR1111 | No output of command/server links |
1 | CMD0202 | Syntax error | |
1 | 64 | NBR1115 | Semantic operand error |
Example
/show-cmd-attr show-conslog
+XAAN |SHOW-CONSLOG-ATTRIBUTES |E| +XAAN-000.115709 % NBR1122 USE/HELP-MSG-INFORMATION MSG-IDENTIFICATION=NBR112 3 FOR EXPLANATION OF OUTPUT ! UCO-000.115709 % NBR0740 COMMAND COMPLETED ‚SHOW-CMD-ATTR'; (RESULT: SC2=000, SC1=000, MC=CMD0001); DATE: 2012-06-30
/SHOW-CMD-ATTR SHOW-CONSLOG,INF=*MAX
+XAAN |SHOW-CONSLOG-ATTRIBUTES |E|N|I|S|
| 1|-|1|
+XAAN-000.115821 % NBR1122 USE /HELP-MSG-INFORMATION MSG-IDENTIFICATION=NBR112
3 FOR EXPLANATION OF OUTPUT
! UCO-000.115821 % NBR0740 COMMAND COMPLETED ‚SHOW-CMD-ATTR'; (RESULT: SC2=000 SC1=000,
MC=CMD0001); DATE: 2012-06-30
/show-cmd-attr cmd-name=*all,entry-name=nbtop,inf=*max
+XAAN |FSTATUS |@|N|I|D|X'71802EB8'| 1|-|1|
+XAAN | FS |@|N|I|D|X'71802EB8'| 1|-|1|
+XAAN |SHOW-FILE-ATTRIBUTES |@|N|I|D|X'71802EB8'| 1|-|1|
+XAAN | SHOW-FILE-ATTR |@|N|I|D|X'71802EB8'| 1|-|1|
+XAAN | SHFA |@|N|I|D|X'71802EB8'| 1|-|1|
+XAAN | SH |@|N|I|D|X'71802EB8'| 1|-|1|
:
+XAAN |SHOW-SPOOL-DEVICES |$|N|I|D|X'71802EB8'| 1|-|1|
+XAAN | SHOW-SPOOL-DEV |$|N|I|D|X'71802EB8'| 1|-|1|
+XAAN |SHOW-SPOOL-FORMS |$|N|I|D|X'71802EB8'| 1|-|1|
+XAAN | SHOW-SPOOL-FORM |$|N|I|D|X'71802EB8'| 1|-|1|
+XAAN |SHOW-SPOOL-CHARACTER-SETS |$|N|I|D|X'71802EB8'| 1|-|1|
+XAAN | SHOW-SPOOL-CHAR |$|N|I|D|X'71802EB8'| 1|-|1|
+XAAN-000.120432 % NBR1122 USE /HELP-MSG-INFORMATION MSG-IDENTIFICATION=NBR112
3 FOR EXPLANATION OF OUTPUT
! UCO-000.120432 % NBR0740 COMMAND COMPLETED ‚SHOW-CMD-ATTR'; (RESULT: SC2=0000,
SC1=000, MC=CMD0001); DATE: 2012-06-30
/help-msg nbr1123
+XAAN-000.120525 % NBR1123 STRUCTURE OF OUTPUT OF /SHOW-CMD-ATTRIBUTES: +XAAN-000.120525 % ? ! Command !C!P!T!M! Server !CIL!A!P! +XAAN-000.120525 % +-------------+ ! ! ! ! ! ! ! ! +XAAN-000.120525 % ! Auth.-Code ! ! ! ! ! ! ! ! +XAAN-000.120525 % +---------------+ ! ! ! ! ! ! ! +XAAN-000.120525 % ! Password P=yes ! ! ! ! ! ! ! +XAAN-000.120525 % ! possible N=no ! ! ! ! ! ! ! +XAAN-000.120525 % +-----------------+ ! ! ! ! ! ! +XAAN-000.120525 % ! Type I=int E=ext ! ! ! ! ! ! +XAAN-000.120525 % +-------------------+ +-----------+ ! ! ! +XAAN-000.120525 % ! Method of call ! ! ! ! +XAAN-000.120525 % ! D=direct S=SDF $=$CONSOLE ! ! ! ! +XAAN-000.120525 % ! - =not available ! ! ! ! +XAAN-000.120525 % +---------------------------------+ ! ! ! +XAAN-000.120525 % ! Comm.-Interval Unit = 5 seconds ! ! ! +XAAN-000.120525 % +-------------------------------------+ ! ! +XAAN-000.120525 % ! Administrability A=yes N=no ! ! +XAAN-000.120525 % +---------------------------------------+ ! +XAAN-000.120525 % ! Priority of server 1=max 4=min ! +XAAN-000.120525 % +-----------------------------------------+ +XAAN-000.120525 % RESPONSE : NONE ! UCO-000.120525 % NBR0740 COMMAND COMPLETED ‚HELP-MSG'; (RESULT: SC2=000, SC1=000, MC=CMD0001); DATE: 2012-06-3