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
- 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.
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.