The SHOWSSA macro shows the current assignment of the specified S variable stream. It is functionally equivalent to the SHOW-STREAM-ASSIGNMENT command. However, it is not possible to specify a list of streams with SHOWSSA.
Operation | Operands |
SHOWSSA | MF = E ,PARAM = <name 1..8> / (<integer 1..15>) |
MF = D ,PREFIX = S / prefix | |
MF = C ,PREFIX = S / prefix ,MACID = HOW / macid | |
MF = L / M ,STREAM = *ALL / *STD_STREAMS / <c-string 1..20 with-wild> ,INFO = *ASSIGNMENT / *DESTINATION ,OUTPUT = *RETURN_CODE / *SYSOUT / *SYSLST |
Operands
MF = E
Execute format of the macro call; generates an SVC.
PARAM
Designates the address of the operand list that is evaluated for the macro call (address of macro call with MF = L).
= <name 1..8>
Designates the symbolic address of the operand list.
= (<integer 1..15>)
Designates the register that contains the address of the operand list.
MF = D
DSECT format of the macro call; generates a DSECT for the operand list. The names generated begin with the letter S; they can be modified with PREFIX.
PREFIX = S / prefix
Defines the first character of the generated names.
Default: the generated names begin with the letter S.
MF = C
C format of the macro call; generates an operand list whose symbolic names begin with the string SHOW. They can be changed with PREFIX and MACID.
PREFIX = S / prefix
Defines the first character of the generated names.
Default: the generated names begin with the letter S.
MACID = HOW / macid
A string of up to three characters that replaces characters 2 to 4 of the generated names. Default: HOW.
MF = L / M
LIST format of the macro call; generates the operand list for the macro call with MF = E (Execute format); the macro call must be addressable by means of a symbolic address.
STREAM
Name of the S variable stream which is to be output. Lists are not supported.
= *ALL
All the S variable streams which are visible in the current procedure will be listed.
= *STD_STREAMS
All the standard streams which are implemented in the system will be displayed. The names of all these streams are prefixed by “SYS”. The names which will be listed are those contained in the value list of the syntax specification for the STREAM-NAME operand of the ASSIGN-STREAM command.
= <c-string 1..20>
The S variable stream which is to be displayed. When wildcards are used, all the S variable streams which match this search pattern will be displayed.
INFORMATION
Specifies which data items must be output.
= *ASSIGNMENT
The “TO” value in the ASSIGN-STREAM command is to be output.
If this stream name is assigned to another stream name, the latter will be output.
= *DESTINATION
The name of the current server which is linked to the S variable stream will be output.If the variable stream is assigned to another variable stream name, the last assignment will be output.
OUTPUT
Specifies where the output of the command is to be sent. Output to an S variable is not possible.
= RETURN_
CODE
Only a return code is returned. This is the default setting. This value is not advisable unless STREAM=<c-string 1..20> (i.e. a name without wildcards) was specified .
= *SYSOUT
Output to SYSOUT.
= *SYSLST
Output to SYSLST.
Return codes
The table below lists the return codes in hexadecimal notation.
00 | 00 | 0000 | Macro call was successful; no errors |
00 | 01 | 0001 | Parameter error |
00 | 40 | 0002 | Specified variable stream is incomplete |
00 | 40 | 0003 | SSTA error (SSTA too small, not initialized, ...) |
00 | 40 | 0004 | Terminated by K2 during output to SYSOUT |
00 | 40 | 0005 | Error during output to SYSOUT |
00 | 40 | 0006 | Error during output to SYSLST |
02 | 01 | 0007 | More than one variable stream for OUTPUT=*RETURNCODE |
00 | 20 | 0008 | System error |
02 | 00 | 000A | Specified variable stream is assigned to *DUMMY |
02 | 00 | 000B | Specified variable stream is already assigned |
02 | 00 | 000C | Specified variable stream does not exist |
00 | 01 | FFFF | Unknown unit or function number |
00 | 02 | FFFF | Function not available |
00 | 03 | FFFF | Wrong version of the operand list |
00 | 41 | FFFF | SDF-P is not loaded |
00 | 81 | FFFF | SDF-P no longer working |