Data Manipulation Language Statements › ACCEPT (DC/UCF)

ACCEPT (DC/UCF)

The ACCEPT statement retrieves the following task-related information:

• Current task code
• Task identifier
• Logical terminal identifier
• Physical terminal identifier
• DC/UCF system version
• User identifier (the ID of the user signed on to the task's logical terminal)
• Physical terminal screen dimensions
• System ID

Syntax

►►──── ACCEPT ──┬─ TASK CODE───┬─ INTO (return-location); ────────────────────►◄
                ├─ TASK ID ────┤
                ├─ LTERM ID ───┤
                ├─ PTERM ID ───┤
                ├─ SYSVERSION ─┤
                ├─ USER ID ────┤
                ├─ SCREENSIZE ─┤
                └─ SYSTEM ID ──┘

Parameters.

TASK CODE

Specifies the 1- to 8-character code that invokes the current task.

TASK ID

Specifies the task identifier assigned by the system. The task identifier is a unique sequence number stored in a FIXED BINARY(31) field. At system startup, the DC/UCF system sets the ID to 0. Each time a task executes, the system increments the ID by 1.

LTERM ID

Specifies the 1- to 8-character identifier of the logical terminal associated with the current task. If the current task has no associated logical terminal, the system returns spaces (null value).

PTERM ID

Specifies the 1- to 8-character identifier of the physical terminal associated with the current task. If the current task has no associated physical terminal, the system returns spaces (null value).

SYSVERSION

Specifies the version number of the current DC/UCF system. The version number is an integer in the range 0 through 9999 stored in a halfword binary numeric field.

USER ID

Specifies the 32-character identifier of the user signed on to the logical terminal associated with the current task. If no user is signed on, the system returns spaces (null value).

SCREENSIZE

Specifies the screen dimensions of the current task's associated physical terminal. The system returns the screen size to a field divided into two FIXED BINARY(15) fields. The first field contains the row; the second field contains the column. For example, values of 24 in the first halfword and 80 in the second halfword represent a 24-line by 80-character screen. If the current task has no associated terminal, the system returns a null value of 0.

SYSTEM ID

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

INTO (return-location)

Specifies the location to which the DC/UCF system returns the requested task-related information. Return-location specifies the symbolic name of a user-defined field. The pictures and usages of this field and of the requested data must be compatible.

Example

The following ACCEPT statements illustrate retrieving the ID of the current task and the id of the user signed on to the task's associated logical terminal:

ACCEPT TASK ID INTO (TASK_ID);
ACCEPT USER ID INTO (USER_ID);

Status Codes

Upon completion of the ACCEPT function, the ERROR_STATUS field in the IDMS DC communications block indicates the outcome of the operation: