Input parameters for the function routine are:
- SSOB
- SSIB
- SSCM
- Command Sensitive Area
- MGCRPL
SSOB Contents: MVS™ sets the following fields in the SSOB control
block on input:
- Field Name
- Description
- SSOBID
- Identifier 'SSOB'
- SSOBLEN
- Length of the SSOB (SSOBHSIZ) control block
- SSOBFUNC
- SSI function code 10 (SSOBCMND)
- SSOBSSIB
- Address of the SSIB control block
- SSOBINDV
- Address of the function dependent area (SSCM control block)
SSIB Contents: MVS sets the following fields in the SSIB control
block on input:
- Field Name
- Description
- SSIBID
- Identifier 'SSIB'
- SSIBLEN
- Length of the SSIB (SSIBSIZE) control block
- SSIBSSNM
- Subsystem name 'MSTR'
SSCM Contents: MVS sets the following fields in the SSCM control
block on input:
- Field Name
- Description
- SSCMLEN
- Length of the SSCM (SSCMSIZE) control block
- SSCMVRSN
- Version level of the SSCM (SSCMVRID) control block
- SSCMBUFF
- Address of the command buffer in the MGCRPL control block
- SSCMACRN
- Identifier 'SSCM'
- SSCMAUTH
- Command authority of command issuer — see the SSCM control
block information for the definition of flags within this byte.
- SSCMDISP
- Disposition flags — see the SSCM control block information
for the definition of flags within this byte.
- SSCMBLEN
- Length of the command buffer pointed to by the SSCMBUFF field.
- SSCMOLIB
- If the command text was changed by symbolic substitution (indicated
by an ON value in the SSCMSYMS field), this field contains a DSECT
that maps the original command text (the text that existed before
symbolic substitution occurred).
- SSCMOLIP
- If the command text was changed by symbolic substitution (indicated
by an ON value in the SSCMSYMS field), this field contains the address
of the SSCMOLIB structure.
- SSCMSYMS
- The command text was changed by symbolic substitution.
- SSCMUTOK
- Address of the UTOKEN
The UTOKEN identifies the issuer of
the command. The RACROUTE macro accepts the UTOKEN to perform command
authorization checking using a security product (RACF®).
- SSCMULTH
- Length of the UTOKEN
- SSCMCNID
- 4-byte console ID — identifies the console that the command
was issued from.
- SSCMSCNM
- Console name of the console whose ID is in the SSCMCNID
- SSCMCTXT
- Address of a 126-byte buffer containing the command text
- SSCMCLEN
- Length of command text
- SSCMCART
- Command and response token
To identify the source of the
command, all command responses issued by a function routine through
a WTO or WTOR should specify either SSCMCNID or SSSCNM and SSCMCART.
- SSCMCXPT
- Address of command sensitive area or zero
Command Sensitive Area Contents: MVS sets the following fields in
the command sensitive area for a REPLY command on input. The address
of this area (when present) is available in the SSCMCXPT field. If
not present, SSCMCXPT=0.
- Field Name
- Description
- SSCMCVRB
- Command identifier — REPLY
- SSCMRTCB
- TCB address of the WTOR issuer
- SSCMRASI
- ASID of the WTOR issuer
- SSCMRTXT
- Offset to the reply text in the area pointed to by either the
SSCMCTXT field or SSCMBUFF+4.
- SSCMRFLG
- Reply flag
- SSCMRSEC — indicates whether the REPLY
is to a security WTOR (route code of 9).
MGCRPL Contents: The address of the
MGCRPL control block is available in the SSCMBUFF. MVS sets the following fields in the MGCRPL control
block on input:
- Field Name
- Description
- MGCRLGTH
- Length of the command text + 4
- MGCRFLG2
- Command processing flags — see the MGCRPL control block
information for a definition of these flags.
- MGCRTEXT
- Command text