Previous Topic: #LINK SyntaxNext Topic: #LINK Status Codes


#LINK Parameters

PGM=

Specify the program and/or entry-point address of the program to which control is transferred.

program-name-pointer

Specifies the 1- to 8-character name of the program to which control is transferred. Program-name is a register that points to a field that contains the program name, the symbolic name of a user-defined field that contains the program name, or the program-name literal enclosed in quotation marks.

entry-point-address

Specifies the entry-point address of the program to which control is transferred. Entry-point-address is a register or symbolic name of a fullword user-defined field that contains the entry-point address.

PLIST=

Specifies the location of the storage area that contains one or more parameters to be passed to the program receiving control.

SYSPLIST

(Default); is the symbolic name of the storage area in which the system will build the parameter list.

parameter-value-list-pointer

A register that points to the area in which the system will build the list or the symbolic name of that area.

The size of the parameter-list area, in fullwords, must be equal to 2 plus the number of parameters listed in the PARMS parameter described below.

Thus, if no parameters are specified (PARMS=NO), the length of this storage area is two fullwords; if one parameter is specified, the length is three fullwords.

PARMS=

Specifies the location of each parameter to be passed to the program receiving control.

NO

(Default); indicates that no parameters will be passed to the program.

parameter-pointer

Indicates that parameters are to be passed to the program. Parameter is a register that contains the address of the parameter or the symbolic name of a user-defined field that contains the parameter.

The parameter list must be enclosed in parentheses. If multiple parameters are specified, each is separated from the previous one by a comma.

COND=

Specifies whether this #LINK is conditional; that is, whether control should be returned to the issuing program in the event of an error:

NO

(Default); specifies that the request is not conditional.

PGNA

Specifies that the request is conditional. Control is returned if the #LINK cannot be serviced because the program is not available.

PGNAXIT=program-not-available-label

Specifies the symbolic name of the routine to which control should be returned if the #LINK request cannot be serviced because the program is not available.

ERROR=error-label

Specifies the symbolic name of the routine to which control should be returned if a condition specified in the COND parameter occurs for which no other exit routine was coded. In this case, the ERROR parameter functions the same as PGNAXIT.