ASSIGN

Requests values from outside the application program's local environment.

ASSIGN

[ CWALENGTH(data-area) ]
[ TCTTUALENG(data-area) ]
[ TWALENG(data-area) ]
[ SCRHT(data-area) ]
[ SCRWT(data-area) ]
[ PAGENUM(data-area) ]
[ FACILITY(data-area) ]
[ OPCLASS(data-area) ]
[ OPID(data-area) ]
[ OPSECURITY(data-area) ]
[ TERMCODE(data-area) ]
[ USERID(data-area) ]
[ NETNAME(data-area) ]
[ QNAME(data-area) ]
[ MAPHEIGHT(data-area) ]
[ MAPWIDTH(data-area) ]
[ MAPLINE(data-area) ]
[ STARTCODE(data-area) ]
[ ABCODE(data-area) ]
[ ABPROGRAM(data-area) ]
[ APPLID(data-area) ]
[ SYSID(data-area) ]
[ PROGRAM(data-area) ]
[ PRINSYSID(data-area) ]
[ INVOKINGPROG(data-area) ]

Options

CWALENGTH

returns an halfword binary field indicating the length of CWA. If no CWA exists, a zero length is returned.

TCTTUALENG

returns an halfword binary field indicating the length of TCTUA.

TWALENG

returns an halfword binary field indicating the length of TWA.

SCRHT

returns an halfword binary field indicating the screen height in characters for the current terminal..

SCRWT

returns an halfword binary field indicating the screen width in characters for the current terminal.

PAGENUM

returns an halfword binary field indicating the number of the page, where overflow condition occurred.

FACILITY

returns a 4-bytes identifier of the principal facility that initiated the task.

OPCLASS

returns, in a 24-bit string, the class of the operator.

OPID

returns the 3-bytes operator identifier

OPSECURITY

returns the opkey of the operator.

TERMCODE

returns a 2-bytes code giving the type and model of the terminal. Supported only for compatibility reasons, returns:

•	0xC000 for APPC sessions

•	0x91F2 for standard terminals

USERID

returns the 8-bytes identifier of the user currently signed-on.

NETNAME

returns the 8-bytes identifier of the terminal device.

QNAME

returns the 4-bytes identifier of the transient data queue that initiated the task by trigger level.

MAPHEIGHT

returns a halfword binary indicating the height of the most recently positioned map.

MAPWIDTH

returns a halfword binary indicating the width of the most recently positioned map.

MAPLINE

returns a halfword binary indicating number of the line on the display containing the origin of the most recently positioned map.

STARTCODE

returns a 2-bytes identifier indicationg how the task was started. It can have the following values:

•	D - a distributed program link (DPL), without SYNCONRETURN option.

•	DS - a distributed program link (DPL), with SYNCONRETURN option.

•	QD - Transient data trigger level

•	S - START without data

•	SD - START with data

•	TD - terminal input

ABCODE

returns a 4-bytes identifier of the current abend code.

ABPROGRAM

returns an 8-character name of the failing program for the latest abend.

If the abend originally occurred in a DPL server program running in a remote system, ABPROGRAM returns the DPL server program name.

This field is set to binary zeros if it is not possible to determine the failing program at the time of the abend.

APPLID

returns the 8-bytes application name of the XCICS region owing the transaction

SYSID

returns the 4-bytes identifier of the XCICS region owing the transaction

PROGRAM

returns the 8-byte identifier of the currently running program.

PRINSYSID

returns the 4-bytes identifier, as defined in "define connection", of the remote region that initiated the APPC session.

INVOKINGPROG

returns the 8-byte identifier of the program that used LINK or XCTL to transfer the control to the current program.

If the command is issued at highest level, 8 blanks are returned.