Change some terminal attributes and cancel outstanding AIDs.
SET TERMINAL >>-SET TERMINAL(data-value)--+------------------+---------------> +-ACQSTATUS(cvda)--+ +-TERMSTATUS(cvda)-+ +-ACQUIRED---------+ +-COLDACQ----------+ '-RELEASED---------' >--+------------------------+--+--------------------+-----------> '-ALTPRINTER(data-value)-' +-ALTPRTCOPYST(cvda)-+ +-ALTPRTCOPY---------+ '-NOALTPRTCOPY-------' >--+-----------------+--+------------------+--------------------> +-ATISTATUS(cvda)-+ +-CREATESESS(cvda)-+ +-ATI-------------+ +-CREATE-----------+ '-NOATI-----------' '-NOCREATE---------' >--+-----------------+--+-------------------+-------------------> +-DISCREQST(cvda)-+ +-EXITTRACING(cvda)-+ +-DISCREQ---------+ +-EXITTRACE---------+ '-NODISCREQ-------' '-NOEXITTRACE-------' >--+---------------------+--+------------------------+----------> '-MAPNAME(data-value)-' '-MAPSETNAME(data-value)-' >--+-------------------------+--+------------------+------------> '-NEXTTRANSID(data-value)-' +-OBFORMATST(cvda)-+ +-OBFORMAT---------+ '-NOOBFORMAT-------' >--+--------------------+--+------------------+-----------------> '-OPERID(data-value)-' +-PAGESTATUS(cvda)-+ +-AUTOPAGEABLE-----+ '-PAGEABLE---------' >--+---------------------+--+-----------------+-----------------> '-PRINTER(data-value)-' +-PRTCOPYST(cvda)-+ +-PRTCOPY---------+ '-NOPRTCOPY-------' >--+------------------+--+----------------+---------------------> +-PURGETYPE(cvda)--+ +-RELREQST(cvda)-+ +-FORCEPURGE-------+ +-RELREQ---------+ +-KILL-------------+ '-NORELREQ-------' +-PURGE--+-------+-+ | '-FORCE-' | '-CANCEL-----------' >--+------------------+--+-------------------------+------------> +-SERVSTATUS(cvda)-+ '-TCAMCONTROL(data-value)-' +-INSERVICE--------+ '-OUTSERVICE-------' >--+--------------------------+--+---------------+--------------> '-TERMPRIORITY(data-value)-' +-TRACING(cvda)-+ +-SPECTRACE-----+ '-STANTRACE-----' >--+-----------------+--+----------------+----------------------> +-TTISTATUS(cvda)-+ +-UCTRANST(cvda)-+ +-NOTTI-----------+ +-UCTRAN---------+ '-TTI-------------' +-NOUCTRAN-------+ '-TRANIDONLY-----' >--+------------------+---------------------------------------->< +-ZCPTRACING(cvda)-+ +-NOZCPTRACE-------+ '-ZCPTRACE---------'
Conditions: INVREQ, NORMAL, NOTAUTH, TERMIDERR
For more information about the use of CVDAs, see CICS-value data areas (CVDAs).
The SET TERMINAL command changes some of the values of a named terminal definition. It cannot be used for APPC sessions.
Only PURGETYPE, PURGE, or FORCEPURGE can be used for IRC sessions.
If a terminal TCTTE is available in a remote system, in either model or surrogate form, a change can be made to TRACING or NEXTTRANSID in the remote definition. This change is not shipped back to the TOR. This allows the user to make a change that applies only to the remote TCTTE.
The SET TERMINAL command can also be used to change the UCTRANST option of a surrogate terminal. This change is shipped back to the TOR and intermediate systems. Any attempt to change any other attribute for a model or surrogate terminal results in INVREQ with RESP2=24.
See the CICS® Resource Definition Guide for information about the PRINTER and ALTPRINTER parameters for defining primary and alternate printers for terminals.
See the CICS Resource Definition Guide for information about the ALTPRINTCOPY parameter, which specifies the use of the hardware copy feature for the alternate printer on the terminal definition.
A terminal cannot have both NOATI and NOTTI in its status.
It also means that CESF LOGOFF (or GOODNIGHT) from the terminal causes disconnection.
Changes are permitted to a remote TCTTE, but the change is not shipped back to the TOR.
See the CICS Resource Definition Guide for information about the PRINTCOPY parameter, which specifies the use of the hardware copy feature for the primary printer on the terminal definition.
When a canceled scheduled request is found to have a precursor in a remote CICS system, this remote AID is canceled asynchronously. Message DFHTF0100 is written to CSMT to indicate how many AIDs have been deleted for the terminal and how many remain.
FORCEPURGE replaces PURGE FORCE, which is retained only for compatibility purposes. You should use FORCEPURGE in new applications.
PURGETYPE cannot be specified for non-VTAM terminals.
If the execution diagnostic facility (EDF) is in use at the specified terminal, EDF stops immediately, because it is a sequence of separate transactions, while the transaction that is being tested under EDF is allowed to complete.
If you set a VTAM terminal to OUTSERVICE, it is also RELEASED and the operator is signed off, either immediately or when the current transaction has terminated. You cannot therefore set the terminal associated with the executing transaction to OUTSERVICE, unless it is a printer.
Changes are permitted to a remote TCTTE, but the change is not shipped back to the TOR.
A terminal cannot be defined with both NOATI and NOTTI.
If a terminal TCTTE is available in a remote system, in either model or surrogate form, a change can be made to TRACING or NEXTTRANSID in the remote definition. This change is not shipped back to the TOR. This allows the user to make a change which applies only to the remote TCTTE. The SET TERMINAL command can also be used to change the UCTRANST option of a surrogate terminal. This change is shipped back to the TOR and intermediate systems. Attempting to change any other attribute for a model or surrogate terminal results in INVREQ with RESP2=24.
This command may be used to set the uppercase translation option for a remote terminal, if the named terminal is the principal facility of the task issuing the command. If the remote terminal is not the principal facility, the INVREQ condition is raised with a RESP2 value of 24. The uppercase translation option is also changed in the terminal-owning region and any intermediate region in a daisy-chaining setup. CVDA values are:
Profile | Terminal (TYPETERM) | ||
---|---|---|---|
UCTRAN (YES) | UCTRAN (NO) | UCTRAN (TRANID) | |
UCTRAN (YES) | Tranid: Yes
Data: Yes |
Tranid: No
Data: Yes |
Tranid: Yes
Data: Yes |
UCTRAN (NO) | Tranid: Yes
Data: Yes |
Tranid: No
Data: No |
Tranid: Yes
Data: No |
Note:
This table shows which portion of the terminal input is translated (transaction
id and/or data) according to the setting of the UCTRAN on the PROFILE and
TYPETERM resource definitions. |