EXEC CICS FORMATTIME ABSTIME(wstime)

END-EXEC

EXEC CICS FORMATTIME ABSTIME(wstime) DATESEP('-') DDMMYY(date) TIME(time) TIMESEP END-EXEC

The following example shows the effect of some of the options of the command. Let "utime" contain the value 002837962864828 in milliseconds.

ASSIGN

EXEC CICS ASSign ABCode() ABDump() ABProgram() ALTSCRNHt() ALTSCRNWd() APLKybd() APLText() APPlid() USERID() USERNAME() ... END-EXEC

ASSIGN gets values from outside the local environment of the application program. The data obtained depends on the specified options. Up to sixteen options can be specified in one ASSIGN command.

Notes:

Where any of the following options apply to terminals or terminal-related data, the reference is always to the principal facility.

If the principal facility is a remote terminal, the data returned is obtained from the local copy of the information; the request is not routed to the system to which the remote terminal is attached.

Transaction routing is as far as possible transparent to the ASSIGN command. In general, the values returned are the same whether the transaction is local or remote.

Options

ABCODE(data-area)

returns a 4-character current abend code

ABDUMP(data-area)

returns a 1-byte value. X'FF' indicates that an EXEC CICS ABEND ABCODE command was issued without the NODUMP option and that ABCODE contains an abend code. X'00' indicates either that no dump has been produced, or that ABCODE contains blanks.

ABPROGRAM(data-area)

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.

When the latest abend is an APCT (resulting from an unsuccessful attempt to load a program, mapset or partitionset), the name is taken from the program, mapset or partitionset that was not loaded.

ACTIVITY(data-area)

returns, if this program is executing on behalf of a CICS business transaction services (BTS) activity, the 16-character name of the activity. ACTIVITYID(data-area)

returns, if this program is executing on behalf of a BTS activity, the 52-character, CICS-assigned, identifier of the activity-instance. ALTSCRNHT(data-area)

returns the alternate screen height defined for the terminal as a halfword binary variable. If the task is not initiated from a terminal, INVREQ occurs.

ALTSCRNWD(data-area)

returns the alternate screen width defined for the terminal as a halfword binary variable. If the task is not initiated from a terminal, INVREQ occurs.

APLKYBD(data-area)

returns a 1-byte indicator showing whether the terminal keyboard has the APL keyboard feature. X'FF' indicates "yes". X'00' indicates "no". If the task is not initiated from a terminal, INVREQ occurs.

APLTEXT(data-area)

returns a 1-byte indicator showing whether the terminal keyboard has the APL text feature. X'FF' indicates "yes". X'00' indicates "no". If the task is not initiated from a terminal, INVREQ occurs.

APPLID(data-area)

returns an 8-character applid of the CICS system owning the transaction. If your system is using XRF (that is, XRF=YES has been specified in the system initialization parameters), the value returned is the

generic applid (that is, the applid that identifies the active and alternate CICS systems). An application

program is unaffected by a takeover from the active to the alternate. ASRAINTRPT(data-area)

returns an 8-character data-area containing the ILC (Instruction length code) and the PIC (Program interrupt code) at the point when the latest abend with a code of ASRA, ASRB, ASRD, or AICA occurred. The field contains binary zeros if no ASRA, ASRB, ASRD, or AICA abend occurred during the execution of the issuing transaction, or if the abend originally occurred in a remote DPL server program. When valid, the contents of the eight bytes returned are: ILC (2 bytes binary), PIC (2 bytes binary), filler (4 bytes binary, always zero).

ASRAKEY(cvda)

returns the execution key at the time of the last ASRA, ASRB, AICA, or AEYD, abend, if any. CVDA values are:

CICSEXECKEY

is returned if the task was executing in CICS-key at the time of the last ASRA, ASRB, AICA, or AEYD abend. Note that all programs execute in CICS key if CICS subsystem storage protection is not active.

USEREXECKEY

is returned if the task was executing in user-key at the time of the last ASRA, ASRB, AICA, or AEYD abend.

NONCICS

is returned if the execution key at the time of the last abend was not one of the CICS keys; that is, not key 8 or key 9.

NOTAPPLIC

is returned if there has not been an ASRA, ASRB, AICA, or AEYD abend.

ASRAPSW(data-area)

returns an 8-character data-area containing the program status word (PSW) at the point when the latest abend with a code of ASRA, ASRB, ASRD, or AICA occurred. The field contains binary zeros if no ASRA, ASRB, ASRD, or AICA abend occurred during the execution of the issuing transaction, or if the abend originally occurred in a remote DPL server program.

ASRAREGS(data-area)

returns the contents of general registers 0-15 at the point when the latest ASRA, ASRB, ASRD, or AICA abend occurred. The contents of the registers are returned in the data area (64 bytes long) in the order 0, 1, ..., 14, 15.

Note that the data area is set to binary zeros if no ASRA, ASRB, ASRD, or AICA abend occurred during the execution of the issuing transaction or the abend originally occurred in a remote DPL server program.

ASRASPC(cvda)

returns the type of space in control at the time of the last ASRA, ASRB, AICA, or AEYD, abend, if any. The CVDA values on the ASRASPC option are:

SUBSPACE

is returned if the task was executing in either its own subspace or the common subspace at the time of the last ASRA, ASRB, AICA, or AEYD abend.

BASESPACE