Changes some of the attributes of a terminal.

Sintaxe:

The options are sequenced alphabetically (A through O):

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

The remaining options are sequenced alphabetically (P through S):

>>-+------------------+--+---------------------+---------------->
   +-PAGESTATUS(cvda)-+  '-PRINTER(data-value)-'
   +-AUTOPAGEABLE-----+
   '-PAGEABLE---------'
 
>--+-----------------+--+-----------------+--------------------->
   +-PRTCOPYST(cvda)-+  +-PURGETYPE(cvda)-+
   +-PRTCOPY---------+  +-FORCEPURGE------+
   '-NOPRTCOPY-------'  +-PURGE-+-------+-+
                        |       '-FORCE-' |
                        '-CANCEL----------'
 
>--+----------------+--+------------------+--------------------><
   +-RELREQST(cvda)-+  +-SERVSTATUS(cvda)-+
   +-RELREQ---------+  +-INSERVICE--------+
   '-NORELREQ-------'  '-OUTSERVICE-------'
 
 

The remaining options are sequenced alphabetically (T through Z):

>>-+-------------------------+--+--------------------------+---->
   '-TCAMCONTROL(data-value)-'  '-TERMPRIORITY(data-value)-'
 
>--+------------------+--+---------------+---------------------->
   +-TERMSTATUS(cvda)-+  +-TRACING(cvda)-+
   +-ACQSTATUS(cvda)--+  +-SPECTRACE-----+
   +-ACQUIRED---------+  '-STANTRACE-----'
   +-COLDACQ----------+
   '-RELEASED---------'
 
>--+-----------------+--+----------------+---------------------->
   +-TTISTATUS(cvda)-+  +-UCTRANST(cvda)-+
   +-NOTTI-----------+  +-UCTRAN---------+
   '-TTI-------------'  +-NOUCTRAN-------+
                        '-TRANIDONLY-----'
 
>--+------------------+----------------------------------------><
   +-ZCPTRACING(cvda)-+
   +-NOZCPTRACE-------+
   '-ZCPTRACE---------'
 
 

For more information about the use of CICS-value data areas (CVDAs), see Appendix F, CVDAs recognized by the translator.

Descrição:

SET TERMINAL allows you to change some of the attributes that are in the runtime Terminal Definitions (WD) for a named terminal.
This command cannot be used for advanced program-to-program communications (APPC) definitions.
An APPC conversation allows a program to send data to, and receive data from, a program that is running in a remote system.
Programming that uses APPC conversations is called Distributed Transaction Programming (DTP).
For guidance information about DTP, refer to the TXSeries for Multiplatforms Intercommunication Guide.

Nota:

If a terminal control table terminal entry (TCTTE) is available in a remote system, in either model or surrogate form, a change can be made to the TRACING or NEXTTRANSID options in the remote definition.
This change is not shipped back to the terminal-owning region (TOR).
This allows the user to make a change that applies only to the remote TCTTE.
Any attempt to change any other attribute for a model or surrogate terminal causes the INVREQ condition RESP2=24.

Opções:

ACQSTATUS(cvda)
• Specifies the status of the terminal.
• This option is included only for compatibility purposes.
• Use the TERMSTATUS option in new applications.
• The values that are supplied are checked, but no other actions taken.
  The CVDA values are:
  • ACQUIRED
  • COLDACQ
  • RELEASED
• See the description for the TERMSTATUS option.

ALTPRINTER(data-value)
• Specifies the name of a 3270 printer that is to be used as an alternative to the printer that is defined for the PRINTER option.
• The name can be up to four characters long.
• Nota:
  • You cannot specify the ALTPRINTER option for a terminal that does not have a primary printer defined for the PRINTER parameter.
• TXSeries for Multiplatforms ignores this option.

ALTPRTCOPYST(cvda)
• Specifies the alternate printer copy status.
• It indicates whether CICS is to use the hardware COPY feature to satisfy a print request on the printer that is named on the ALTPRINTER parameter.
• THE CVDA values are:
  • ALTPRTCOPY
    • CICS is to use the hardware COPY feature to satisfy a print request on the alternative printer.
  • NOALTPRTCOPY
    • CICS is not to use the hardware COPY feature.
  • Nota:
    • You cannot specify the ALTPRTCOPY option for a terminal that does not have an alternative printer defined.
• TXSeries for Multiplatforms checks this option only for validity; otherwise, it ignores the option.

ATISTATUS(cvda)
• Specifies whether the terminal is to be available for use by transactions that are automatically initiated from within CICS.
• The CVDA values are:
  • ATI
    • The terminal can be used by automatically initiated transactions.
  • NOATI
    • The terminal cannot be used by automatically initiated transactions.
    • The terminal is an intersystem communication (ISC) session; it is for transactions that are using this session as an alternative facility to communicate with another system.
• A terminal cannot have both NOATI and NOTTI in its status.
• See the description for the TTISTATUS option for more information about the NOTTI value.

CREATESESS(cvda)
• Specifies whether the terminal can be acquired automatically by ATI transactions.
  THE CVDA values are:
  • CREATE
    • The terminal can be acquired automatically.
  • NOCREATE
    • The terminal cannot be acquired automatically.
• TXSeries for Multiplatforms checks this option only for validity; otherwise, it ignores the option.

DISCREQST(cvda)
• Specifies whether CICS is to honor a disconnect request from the terminal.
  The CVDA values are:
  • DISCREQ
    • CICS honors a disconnect request for a Virtual Telecommunications Access Method (VTAM) device, and issues a VTAM CLSDST macro instruction to terminate the VTAM session with that logical unit.
    • It also means that the CESF LOGOFF (or GOODNIGHT) command from the terminal causes disconnection.
  • NODISCREQ
    • CICS does not honor a disconnect request for a VTAM device.
• TXSeries for Multiplatforms checks this option only for validity; otherwise, it ignores the option.

EXITTRACING(cvda)
• Specifies whether the activity that is associated with the terminal exit program is to be traced.
  The CVDA values are:
  • EXITTRACE
    • Exit program activity is to be traced.
  • NOEXITTRACE
    • Exit program activity is not to be traced.
• TXSeries for Multiplatforms checks this option only for validity; otherwise, it ignores the option.

MAPNAME(data-area)
• Specifies the seven-character name of the map that is to be saved (stored) by CICS as the name of the last map that was sent to this device.
• If this terminal is a surrogate, the map name that is specified is returned in the DETACH sequence to the terminal-owning region (TOR) when the currently executing transaction terminates, unless the map name is superseded by a subsequent SEND MAP command.
• You can use the MAPNAME option to restore a map name that was returned to the application program in a previous INQUIRE TERMINAL command.
• If the terminal is not supported by basic mapping resource (BMS), for example, this terminal is a session, an INVREQ condition is raised.

MAPSETNAME(data-area)
• Specifies the eight-character name of the mapset that is to be saved by CICS as the name of the last mapset that was used in a SEND MAP command that was processed for this terminal.
• If this terminal is a surrogate, the mapset name that is specified is returned in the DETACH sequence to the terminal-owning region when the currently executing transaction terminates, unless the mapset name is superseded by a subsequent SEND MAP command.
• The MAPSETNAME option can be used to restore a mapset name that was returned to the application program in a previous INQUIRE TERMINAL command.
• If the terminal is not supported by BMS (for example, this terminal is a session), an INVREQ condition is raised.

NEXTTRANSID(data-value)
• Specifies the next transaction identifier for the specified terminal.
• The identifier can be up to four characters long.
• If you specify a null value for the NEXTTRANSID parameter, CICS sets the next transaction identifier to null, which means no NEXTTRANSID is defined for the terminal.
• Changes are permitted to a terminal entry in a remote terminal control table (TCTTE), but the change is not shipped back to the terminal-owning region (TOR).

OBFORMATST(cvda)
• Specifies whether the device supports outboard formatting.
  The CVDA values are:
  • NOOBFORMAT
    • The device does not support outboard formatting.
  • OBFORMAT
    • The device supports outboard formatting.
• TXSeries for Multiplatforms checks this option only for validity; otherwise, it ignores the option.

PAGESTATUS(cvda)
• Specifies how pages are to be written.
  The CVDA values are:
  • AUTOPAGEABLE
    • Pages, after the first in a series, are to be written to the terminal automatically.
  • PAGEABLE
    • Pages, after the first in a series, are to be written to the terminal on request from the operator.
• TXSeries for Multiplatforms checks this option only for validity; otherwise, it ignores the option.

PRINTER(data-value)
• Specifies the name of the primary printer that CICS is to use in response to a print request (either from an ISSUE PRINT command, or from a PRINT request that was received from an operator's pressing the print request key).
• The name can be up to four characters long.

PRTCOPYST(cvda)
• Specifies whether CICS is to use the hardware COPY feature to satisfy a print request on the printer that is named on the PRINTER parameter.
  The CVDA values are:
  • NOPRTCOPY
    • CICS is not to use the hardware COPY feature.
  • PRTCOPY
    • CICS is to use the hardware COPY feature to satisfy a print request on the primary printer.
      • Nota:
        You cannot specify the PRTCOPY option for a terminal that does not have a printer defined.
• TXSeries for Multiplatforms checks this option only for validity; otherwise, it ignores the option.

PURGETYPE(cvda)
• Specifies whether transactions that are running with the named terminal can be purged.
  The CVDA values are:
  • CANCEL
    • Attention identifiers (AIDs) that are queueing for the specified terminal are to be canceled.
    • AIDs that represent scheduled and allocated requests that are waiting in the local CICS system for the specified terminal are canceled.
    • However, Transaction Definition (TD) AIDs that have an associated triggered task already started are not canceled.
    • When a canceled scheduled request is found to have a precursor in a remote CICS system, this remote AID is canceled asynchronously.
  • FORCEPURGE
    • Transactions are to be purged immediately.
    • This can lead to unpredictable results, and it is recommended for use only in exceptional circumstances.
  • PURGE
    • The transactions can be terminated only if system and data integrity can be maintained.
• The PURGETYPE option cannot be specified for non-VTAM terminals.

RELREQST(cvda)
• Specifies the status for releasing the logical unit.
• The CVDA values are:
  • NORELREQ
    • CICS is not to release the logical unit upon request by another VTAM application program.
  • RELREQ
    • CICS is to release the logical unit if the logical unit is not currently busy running a transaction.
• TXSeries for Multiplatforms checks this option only for validity; otherwise, it ignores the option.

SERVSTATUS(cvda)
• Specifies whether the terminal is to be available for use.
  The CVDA values are:
  • INSERVICE
    • CICS is to set the terminal as in-service and available for use by transactions.
  • OUTSERVICE
    • CICS is to set the terminal as out-of-service and unavailable for use by transactions.
    • Unless the PURGE option is specified, any currently executing transaction is allowed to terminate normally; no further transactions are allowed to use the terminal.
    • However, if you are using Execution Diagnostic Facility (EDF) operation on the specified terminal, the EDF operation stops immediately, but the transaction that is being tested is allowed to complete.
• It is not valid to set, to OUTSERVICE, the terminal that is associated with the executing transaction, unless the terminal is a printer.
  • Nota:
    • When a terminal is set to OUTSERVICE by using the SERVSTATUS option, it is recommended that a SYNCPOINT be issued to release the lock on the temporary storage queue that holds the terminal details.
    • If a SYNCPOINT is not issued, a problem can occur when reinstalling the terminal.

TCAMCONTROL(data-value)
• Specifies a one-character hexadecimal value in the TCAM control byte that indicates which segment of the message is to be passed between CICS and TCAM.
• TXSeries for Multiplatforms checks this option only for validity; otherwise, it ignores the option.

TERMINAL(data-value)
• Specifies the name of the terminal as defined in the Terminal Definitions (WD).
• The name can be up to four characters long.

TERMPRIORITY(data-value)
• Specifies the prioritythat is to be used for this terminal relative to other terminals.
• This is expressed as a 32-bit binary value in the range 0 through 255.

TERMSTATUS(cvda)
• Specifies the status of the terminal.
• This option is included only for compatibility purposes.
• The values that are supplied will be checked, but no other actions taken.
  The CVDA values are:
  • ACQUIRED
  • COLDACQ
  • RELEASED

TRACING(cvda)
• Specifies the required tracing activity that is associated with the terminal.
  The CVDA values are:
  • SPECTRACE
    • Special tracing is to be used.
  • STANTRACE
    • Standard tracing is to be used.
• TXSeries for Multiplatforms checks this option only for validity; otherwise, it ignores the option.

TTISTATUS(cvda)
• Specifies whether the terminal is to be available for use by transactions that are initiated from this terminal.
  Valid CVDA values are:
  • NOTTI
    • This terminal cannot be used by transactions that are initiated from it.
  • TTI
    • This terminal can be used by transactions that are initiated from it.
• A terminal cannot have NOATI and NOTTI both in its status.
• See the description for the ATISTATUS option for more information about the NOATI option.

UCTRANST(cvda)
• Specifies whether the uppercase translation option is to be set for transactions that are associated with this terminal.
  The CVDA values are:
  • NOUCTRAN
    • CICS is not to perform uppercase translation on input from this terminal (unless specified otherwise on the profile for individual transactions).
  • TRANIDONLY
    • CICS is to perform uppercase translation on the transaction ID only on input from this terminal.
  • UCTRAN
    • CICS is to perform uppercase translation on input from this terminal.

ZCPTRACING(cvda)
• Specifies the required tracing activity that is associated with the VTAM control component of CICS.
  The CVDA values are:
  • NOZCPTRACE
    • VTAM ZCP tracing is not to be performed.
  • ZCPTRACE
    • VTAM ZCP tracing is to be performed.
• TXSeries for Multiplatforms checks this option only for validity; otherwise, it ignores the option.

Condições:

ERROR
• Occurs if an internal CICS error occurs in terminal control.
• Default action: Terminates the task abnormally.

INVREQ
• Occurs for the following conditions, depending on the options that are specified on the SET TERMINAL command:
  • TERMSTATUS or ACQSTATUS was specified for an APPC session (RESP2=1).
  • TERMSTATUS or ACQSTATUS has an invalid CVDA value (RESP2=2).
  • ATISTATUS has an invalid CVDA value (RESP2=4).
  • The change causes a status of both NOATI and NOTTI (RESP2=5).
  • CREATESESS was specified for a non-VTAM terminal (RESP2=6).
  • CREATESESS has an invalid CVDA value (RESP2=7).
  • PAGESTATUS has an invalid CVDA value (RESP2=9).
  • An attempt has been made to set the terminal that is associated with the executing transaction to OUTSERVICE, and this terminal is not a printer (RESP2=11).
  • SERVSTATUS has an invalid CVDA value (RESP2=13).
  • TERMPRIORITY has an out-of-range value (RESP2=15).
  • This terminal cannot be made NOTTI (RESP2=17).
  • TTISTATUS has an invalid CVDA value (RESP2=18).
  • Attempted PURGE on this terminal (RESP2=20).
  • PURGETYPE has an invalid CVDA value (RESP2=21).
  • TRACING has an invalid CVDA value (RESP2=22).
  • Invalid option has been requested for a remote terminal (RESP2=24).
  • ACQUIRED specified, but terminal is not inservice (RESP2=25).
  • EXITTRACING has an invalid CVDA value (RESP2=27).
  • ZCPTRACING has an invalid CVDA value (RESP2=28).
  • SET TERMINAL is not valid for an LU6.2 (APPC) session (RESP2=33).
  • OBFORMATST has an invalid CVDA value (RESP2=38).
  • RELREQST has an invalid CVDA value (RESP2=39).
  • DISCREQST has an invalid CVDA value (RESP2=40).
  • ALTPRTCOPYST has an invalid CVDA value (RESP2=41).
  • PRTCOPYST has an invalid CVDA value (RESP2=42).
  • UCTRANST has an invalid CVDA value (RESP2=43).
  • MAPNAME or MAPSETNAME is specified, but the terminal is not of a type that is supported by BMS (RESP2=60).
• Default action: Terminates the task abnormally.

TERMIDERR
• Occurs if the named terminal cannot be found in the WD (RESP2=23).
• Default action: Terminates the task abnormally.

Informações relacionadas:

• INQUIRE TERMINAL or NETNAME
• INQUIRE TERMINAL (browse)
• CICS-value data areas (CVDA)
• CVDAs sorted by symbolic name
• CVDAs sorted by numeric value
• TXSeries for Multiplatforms Administration Reference