Syntax for Assembler Macros › #SECSGOF › #SECSGOF Parameters

#SECSGOF Parameters

RB=

Specifies the area containing the Security Request Block (SRB) associated with this request. This area is mapped by #SECRB.

The location of the SRB is required because most of the other parameters coded on #SECSGOF will be stored in the SRB.

This parameter is not required if CALL=ONLY.

request-block-area-name

Identifies the symbolic name of the area containing the SRB.

request-block-address

Identifies the register containing the address of the SRB.

,FROMLTE=

Specifies the address of the Logical Terminal Element (LTE) for which signoff will be done.

If you do not specify FROMLTE=, signoff processing will use the task's primary LTE (that is, TCELTEA).

lte-area-name

Identifies the symbolic name of a user-defined area containing the LTE address.

lte-address

Identifies the register containing the LTE address.

,RGSV=

Specifies that one or more registers are to be saved across the call. This parameter is valid in system mode only.

register-number

Specifies a register.

Register-number must be a numeric literal.

Register-number can be specified in the form Rn, where n is a numeric literal. This assumes that the symbol Rn has been equated to the corresponding register number; for example:

R0   EQU   0
R1   EQU   1
R2   EQU   2
 .
 .
 .
R15  EQU  15

These assignments can be made with the macro #REGEQU or explicitly coded in the program.

,CALL=

Controls the expansion of the #SECSGOF macro.

If you omit the CALL parameter, the effect is the same as specifying CALL=YES.

YES

Causes #SECSGOF to generate both the code to complete the SRB and the code to invoke the security system.

NO

Causes #SECSGOF to generate the code to fill in the SRB fields, but not to build the parameter list or the call.

ONLY

Causes #SECSGOF to generate only the code needed to invoke the security system.

,CLEAR=

Specifies whether you want the SRB to be initialized.

If you omit the CLEAR= parameter, the effect is the same as specifying CLEAR=YES. Exception: If CALL=ONLY, the CLEAR parameter defaults to NO.

Yes

Causes #SECSGOF to clear the SRB to binary zeros before the macro expansion begins to assign values.

No

Indicates that the SRB should not be initialized.

,PLIST=

Specifies the area in which to build the parameter list. The parameter list is a three-fullword storage area.

SYSPLIST

Supplies the default name for the area that contains the parameter list.

parameter-list-area-name

Identifies the symbolic name of a user-defined fullword-aligned field that contains the parameter list.

parameter-list-address

Identifies the register containing the address of the parameter list.