CICSCMD Command › CICSCMD SET TERMINAL—Set Terminal Status

CICSCMD SET TERMINAL—Set Terminal Status

The CICSCMD SET TERMINAL command controls the status of CICS terminals. The RCIW06 or RCIW20 message indicates the success or failure of the operation. The function is similar to that provided by the CICS CEMT SET TERMINAL transaction.

This command has the following format:

CICSCMDcics_region_name SET TERMINAL(terminal_name_mask) {INS | OUT} {ACQ | REL}

cics_region_name

Defines the CICS region that owns the terminals whose status is to be set.

terminal_name_mask

Specifies the terminals whose status is to be set. The value can be either the name or a mask. If you use a mask, it must be of the following form: terminal_name_prefix*.

INS | OUT

Specifies whether CICS transactions can use the terminals.

INS

Puts the terminals into service. CICS transactions can use the terminals.

For VTAM terminals, INS enables them to be acquired subsequently.

OUT

Puts the terminals out of service. CICS transactions can no longer use the terminals.

For VTAM terminals, OUT causes them to be released.

ACQ | REL

(VTAM only) Specifies whether to acquire or release the terminals.

ACQ

Acquires sessions with the logical units represented by the terminals.

REL

Releases the sessions with the logical units represented by the terminals.

Example:

CICSCMD CICSA SET TERM(S201) INS

CICSCMD CICSA SET TERM(S201) ACQ