CEMT SET NETNAME

Change the status of networks.

In the CICS Explorer, the Terminals operations view provides a functional equivalent to this command.

Description

If you are familiar with network names, you can use this command as an alternative to the CEMT SET TERMINAL command (see CEMT SET TERMINAL). However, you cannot use the CEMT SET NETNAME command for APPC sessions.

Netname is the name by which the remote system or terminal is known to the network. The remaining operands for NETNAME are identical to those for TERMINAL.

Netnames do not need to be unique, and you cannot specify a list of names.

Syntax

Press the Clear key to clear the screen. You can start this transaction in two ways:
  • Type CEMT SET NETNAME (or suitable abbreviations for the keywords), followed by netname or ALL. The resulting display lists the current status, similar to that obtained by using the CEMT INQUIRE NETNAME command. You can tab to the highlighted or blank fields and overtype them with the required values.
  • Type CEMT SET NETNAME (or suitable abbreviations for the keywords), followed by netname or ALL, then followed by one or more attribute settings that you want to change. For example, cemt s n(netname) i at resets the named remote system or terminal to in service and available for use.

Typing ? at the beginning of either the first or second line gives a syntax prompt. Resetting the values takes effect immediately.

CEMT SET NETNAME

Read syntax diagramSkip visual syntax diagramCEMT SET NETNAME( value)ALLPRIORITY( value)PAGEABLEAUTOPAGEABLEINSERVICEOUTSERVICEATINOATITTINOTTIPURGEFORCEPURGEKILLACQUIREDCOLDACQRELEASEDCREATENOCREATE

Options

(value)
Specifies the name by which the remote terminal is known in the network.
ACQUIRED (z/OS Communications Server only)
CICS® is in session with the logical unit represented by the terminal.
ALL
Specifies that any changes you request are made to all resources of the specified type that you are authorized to access.
ATI (z/OS Communications Server only)
The terminal is available for use by transactions that are initiated automatically from within CICS or, if the terminal is an ISC session, by transactions that are using this session as an alternative facility to communicate with another system.
AUTOPAGEABLE (z/OS Communications Server only)
Pages after the first in a series are to be written to the terminal automatically.
COLDACQ (z/OS Communications Server only)
This is a special form of ACQUIRED, where no resynchronization is required. If the previous session abended, the use of COLDACQ overrides CICS integrity control. This could lead to integrity problems. Also, you should check the CSMT log for an activity keypoint after the restart of a session following a CICS failure. If there is no activity keypoint, you should issue COLDACQ again after the next emergency restart.
CREATE (z/OS Communications Server only)
If the terminal is not in session, CICS is to acquire it if it is needed to satisfy an ATI request. This cannot be specified for IRC sessions.
FORCEPURGE
All transactions running with this terminal are immediately terminated abnormally. Data integrity is not guaranteed. In some extreme cases (for example, if an error occurs during backout processing), CICS might terminate abnormally.
INSERVICE (z/OS Communications Server only)
The terminal is available for use. For z/OS® Communications Server, INSERVICE means that the terminal can be ACQUIRED.
KILL
Terminate the task. System and data integrity is not guaranteed. The KILL option extends the PURGE and FORCEPURGE options. Use this option only after first attempting a purge or forced purge. The KILL option does not guarantee integrity of any kind, but in some situations you can use it to free up a stalled region, thus enabling the region to continue processing. In some cases, for example, if a task is killed during backout processing, CICS terminates abnormally.
NOATI (z/OS Communications Server only)
The terminal is not available for use by transactions that are initiated automatically from within CICS or, if the terminal is an ISC session, by transactions that are using this session as an alternative facility to communicate with another system.
Note: A terminal cannot be defined with both NOATI and NOTTI.
NOCREATE (z/OS Communications Server only)
If the terminal is not in session, CICS is not to acquire it to satisfy an ATI request. A session must be started by, for example, a logon request or a CEMT SET TERMINAL ACQUIRED command before the ATI request can be satisfied.

If NOCREATE is set for an LU6.1 ISC session and there are no allocatable sessions left, the connection is placed OUTSERVICE.

NOTTI (z/OS Communications Server only)
This terminal cannot be used by transactions.
Note: A terminal cannot be defined with both NOATI and NOTTI.
OUTSERVICE (z/OS Communications Server only)
The terminal is not available for use. Setting a terminal OUTSERVICE means that the terminal can no longer be used by transactions. If PURGE or FORCEPURGE is also specified, any transaction using the terminal is terminated abnormally. If PURGE or FORCEPURGE is not specified, the transaction is allowed to terminate normally, but no further transactions are allowed to use the terminal. For z/OS Communications Server, setting a terminal OUTSERVICE also causes it to be released and the operator to be signed off, either immediately or when the current transaction has terminated.

In an LU6.1 ISC session the connection is set OUTSERVICE if there are no allocatable sessions left.

To set an IRC session OUTSERVICE, you must set the connection to the MRO partner OUTSERVICE.

PAGEABLE (z/OS Communications Server only)
Pages after the first in a series are to be written to the terminal only if you request them to be.
PRIORITY (value) (z/OS Communications Server only)
Specifies the priority of a terminal relative to other terminals. The priority of a task is the sum of the transaction priority, the terminal priority, and the operator priority. Priority has no meaning for terminals that are ISC sessions being used as alternative facilities. The value must be in the range 0–255, where 255 is the highest priority.
PURGE
Tasks running on this terminal are abnormally terminated, but task termination occurs only if system integrity can be maintained.
RELEASED (z/OS Communications Server only)
CICS is not in session with the logical unit represented by the terminal. Setting a terminal RELEASED causes the session to be terminated. Running transactions are allowed to finish unless PURGE or FORCEPURGE is also specified.
TTI (z/OS Communications Server only)
This terminal can be used by transactions.