Utility Commands › ACCEPT

ACCEPT

Purpose

Retrieves information about the current task and dialog. (In CA ADS Batch, ACCEPT is used to accept runtime parameters into a storage location.)

Syntax

►►─ ACCept ──┬──┬─ TASK CODE ───────────┬─ INTO location ──┬── . ─────────────►◄
             │  ├─ TASK ID ─────────────┤                  │
             │  ├─ LTERM ID ────────────┤                  │
             │  ├─ PTERM ID ────────────┤                  │
             │  ├─ SYSVERSION ──────────┤                  │
             │  ├─ USER ID ─────────────┤                  │
             │  ├─ current DIALOG name ─┤                  │
             │  ├─ HIGHER DIALOG name  ─┤                  │
             │  ├─ RECORD name ─────────┤                  │
             │  ├─ AREA name ───────────┤                  │
             │  ├─ ERROR SET name ──────┤                  │
             │  ├─ ERROR RECORD name ───┤                  │
             │  ├─ ERROR AREA name ─────┤                  │
             │  ├─ SYSTEM ID ───────────┤                  │
             │  └─┬─ RUN PARameters ─┬──┘                  │
             │    └─ PARMS ──────────┘                     │
             │                                             │
             └─ SCREEN SIZE INTO location1  location2 ─────┘

Parameters

TASK CODE

Retrieves the eight-character code used to invoke the current task.

TASK ID

Retrieves the DC/UCF-assigned task identification number. The task id is a unique sequence number stored in a binary fullword field. The task id is zero when DC/UCF is started and is incremented by one for each new task added to the system.

LTERM ID

Retrieves the eight-character identification of the logical terminal associated with the current task.

PTERM ID

Retrieves the eight-character identification of the physical terminal associated with the current task.

SYSVERSION

Retrieves the version number, in the range 0 to 32767, of the DC/UCF system currently in use. The version number is stored in a binary halfword field.

USER ID

Retrieves the user identification.

In CA ADS, the 32-character identification of the user signed on to the logical terminal associated with the current task is retrieved. If no user is signed on, a null user id (that is, 32 blanks) is returned.

In CA ADS Batch, the user identification specified in the USER (REQUESTOR) input parameter is retrieved.

current DIALOG name

Retrieves the name of the current dialog.

HIGHER DIALOG name

Retrieves the name of the dialog that is operative at the next higher level in the current application thread.

RECORD name

Retrieves the name of the record that is current of run unit for the issuing dialog.

AREA name

Retrieves the name of the area that is current of area for the issuing dialog.

ERROR SET name

Retrieves the name of the last set involved in an operation that resulted in an error condition.

ERROR RECORD name

Retrieves the name of the last record involved in an operation that resulted in an error condition.

ERROR AREA name

Retrieves the name of the last area involved in an operation that resulted in an error condition.

RUN PARameters

(CA ADS Batch only) Retrieves runtime parameters, which are specified in the JCL PARM parameter (z/OS, z/VSE Release 2.1, and z/VM) or in a JOB VARIABLE statement. If no runtime parameters are specified in the JCL, the storage location is blank filled.

PARMS can be used in place of RUN PAR.

SYSTEM ID

Retrieves the 8 character name(nodename) by which the DC/UCF system is known to other nodes in the DC/UCF communications network.

INTO location

Specifies the location to which the information is moved.

Location is the name of a variable data field in the dialog's record buffers. The specified field must have an appropriate picture and usage for the value being retrieved.

SCREEN SIZE INTO location1 location2

Retrieves the dimensions (that is, the number of rows and columns) of the physical terminal screen associated with the current task.

Location1 is the name of a numeric variable data field in the dialog's record buffers to which the number of rows moved.

Location2 is the name of a numeric variable data field in the dialog's record buffers to which the number of columns is moved.