Menu principal                 [Fechar]
Introdução
Divisões
Identification Division
Environment Division
Data Division
Procedure Division
Comandos CICS
VSAM - File Status
Quadros importantes
SQL - Structured Query Language
Outros programas
Rotinas prontas
Palavras reservadas
Introdução ao Oracle
Sites de busca
Sites interessantes
Meu e-mail

CICS Manual do Usuário - INQUIRE TERMINAL ou NETNAME


Volta a página anterior

Volta ao Menu Principal


Desenvolvido por DORNELLES Carlos Alberto - Analista de Sistemas - Brasília DF. - cad_cobol@hotmail.com

INQUIRE TERMINAL ou NETNAME

Retrieves information about a terminal or a session.

Sintaxe: 

INQUIRE TERMINAL
 
>>-INQUIRE TERMINAL(data-value)--+--------------------+--------><
                                 '-NETNAME(data-area)-'

or 

INQUIRE NETNAME
 
>>-INQUIRE NETNAME(name)--+---------------------+--------------><
                          '-TERMINAL(data-area)-'

The remaining options are sequenced alphabetically and apply to both forms of the command (A through D): 

INQUIRE TERMINAL or INQUIRE NETNAME
 
   .---------------------------.
   V                           |
>>---+-----------------------+-+-------------------------------><
     +-ACCESSMETHOD(cvda)----+
     +-ACQSTATUS(cvda)-------+
     +-ALTPAGEHT(data-area)--+
     +-ALTPAGEWD(data-area)--+
     +-ALTPRINTER(data-area)-+
     +-ALTPRTCOPYST(cvda)----+
     +-ALTSCRNHT(data-area)--+
     +-ALTSCRNWD(data-area)--+
     +-ALTSUFFIX(data-area)--+
     +-APLKYBDST(cvda)-------+
     +-APLTEXTST(cvda)-------+
     +-ASCII(cvda)-----------+
     +-ATISTATUS(cvda)-------+
     +-AUDALARMST(cvda)------+
     +-AUTOCONNECT(cvda)-----+
     +-BACKTRANSST(cvda)-----+
     +-COLORST(cvda)---------+
     +-COPYST(cvda)----------+
     +-CREATESESS(cvda)------+
     +-DATASTREAM(cvda)------+
     +-DEFPAGEHT(data-area)--+
     +-DEFPAGEWD(data-area)--+
     +-DEFSCRNHT(data-area)--+
     +-DEFSCRNWD(data-area)--+
     +-DEVICE(cvda)----------+
     +-DEVICEST(cvda)--------+
     +-DISCREQST(cvda)-------+
     '-DUALCASEST(cvda)------'

The remaining options are sequenced alphabetically and apply to both forms of the command (E through O): 

   .----------------------------.
   V                            |
>>---+------------------------+-+------------------------------><
     +-EXITTRACING(cvda)------+
     +-EXTENDEDDSST(cvda)-----+
     +-FMHPARMST(cvda)--------+
     +-FORMFEEDST(cvda)-------+
     +-GCHARS(data-area)------+
     +-GCODES(data-area)------+
     +-HFORMST(cvda)----------+
     +-HILIGHTST(cvda)--------+
     +-KATAKANAST(cvda)-------+
     +-LIGHTPENST(cvda)-------+
     +-MAPNAME(data-area)-----+
     +-MAPSETNAME(data-area)--+
     +-MODENAME(data-area)----+
     +-MSRCONTROLST(cvda)-----+
     +-NATLANG(data-area)-----+
     +-NATURE(cvda)-----------+
     +-NEXTTRANSID(data-area)-+
     +-OBFORMATST(cvda)-------+
     +-OBOPERIDST(cvda)-------+
     +-OPERID(data-area)------+
     '-OUTLINEST(cvda)--------'

The remaining options are sequenced alphabetically and apply to both forms f the command (P through S): 

   .-----------------------------.
   V                             |
>>---+-------------------------+-+-----------------------------><
     +-PAGEHT(data-area)-------+
     +-PAGESTATUS(cvda)--------+
     +-PAGEWD(data-area)-------+
     +-PARTITIONSST(cvda)------+
     +-PRINTADAPTST(cvda)------+
     +-PRINTER(data-area)------+
     +-PROGSYMBOLST(cvda)------+
     +-PRTCOPYST(cvda)---------+
     +-QUERYST(cvda)-----------+
     +-RELREQST(cvda)----------+
     +-REMOTENAME(data-area)---+
     +-REMOTESYSTEM(data-area)-+
     +-SCRNHT(data-area)-------+
     +-SCRNWD(data-area)-------+
     +-SECURITY(cvda)----------+
     +-SERVSTATUS(cvda)--------+
     +-SESSIONTYPE(cvda)-------+
     +-SIGNONSTATUS(cvda)------+
     '-SOSIST(cvda)------------'

The remaining options are sequenced alphabetically and apply to both forms of the command (T through Z): 

   .-----------------------------.
   V                             |
>>---+-------------------------+-+-----------------------------><
     +-TASKID(data-area)-------+
     +-TCAMCONTROL(data-area)--+
     +-TERMMODEL(data-area)----+
     +-TERMPRIORITY(data-area)-+
     +-TERMSTATUS(cvda)--------+
     +-TEXTKYBDST(cvda)--------+
     +-TEXTPRINTST(cvda)-------+
     +-TRACING(cvda)-----------+
     +-TRANSACTION(data-area)--+
     +-TTISTATUS(cvda)---------+
     +-UCTRANST(cvda)----------+
     +-USERAREA(ptr-ref)-------+
     +-USERAREALEN(data-area)--+
     +-USERID(data-area)-------+
     +-USERNAME(data-area)-----+
     +-VALIDATIONST(cvda)------+
     +-VFORMST(cvda)-----------+
     '-ZCPTRACING(cvda)--------'

Conditions: END, ILLOGIC, TERMIDERR

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

Descrição:

T he INQUIRE TERMINAL and INQUIRE NETNAME commands both return information about a particular terminal or session that is installed in your CICS system.
You can use them to inquire about any type of terminal resource, including the following types:

  • Physical terminals: These are terminals that are owned locally by the region in which the INQUIRE command is issued.
  • Remote terminals: These are terminals that are defined locally as owned by another region.
  • Surrogate terminals: These are partial definitions that represent terminals that are owned by another region and shipped to the local region the first time the definition is needed.
  • Models: These are definitions that are used only to autoinstall other terminals.

You can also use the INQUIRE TERMINAL command to inquire about an Advanced Program-to-Program Communication (APPC) session.
To get full details about the associated connection, however, you must use an INQUIRE CONNECTION command.

Some of the options in the INQUIRE TERMINAL command return system status information, such as information about whether the terminal is acquired or not, whether it is in use by a task, and so on.
Most options, however, reflect the definition of the terminal or session.
It is possible that these definitions are modified by subsequent SET TERMINAL commands.
A terminal is specified by a workstation (terminal) definition (WD) stanza entry.

The INQUIRE NETNAME command returns the same information as does the INQUIRE TERMINAL command.
With the INQUIRE TERMINAL command, you identify the object of your inquiry by providing its CICS terminal identifier in the TERMINAL option.
The NETNAME value is optional.
If you include it, CICS returns the network identifier in the data area that you provide.

In an INQUIRE NETNAME command, the roles of the TERMINAL and NETNAME values are reversed.
You identify the terminal about which you are inquiring by supplying its network identifier in the NETNAME option, and CICS returns the corresponding CICS terminal identifier in the TERMINAL value, if you also include that option.

The TERMINAL value must appear before the NETNAME value (if present) in an INQUIRE TERMINAL command, and vice versa in an INQUIRE NETNAME command.

All of the other options apply to both commands and return the same information.
Not all options apply to all types of terminals, however.
In particular, when CICS ships a terminal definition from the owning region to a remote region, an inquiry that is issued in the owning region (where the definition is of a real terminal) produces more information than an inquiry that is issued in the remote region, where the definition is a surrogate for the one that is in the owning region.

You can also browse through the definitions of all the terminals that are installed in your system by using the browse options (START, NEXT, and END) on INQUIRE TERMINAL commands. (The browse options are not available on INQUIRE NETNAME commands.)

Opções:

    ACCESSMETHOD(cvda)
  • Returns a CVDA value that indicates the access method that is defined for the terminal. The CVDA values are:
    • RPC
      • The access is via RPC.
    • TCPIP
      • The access method is TCP/IP.
    • VTAM(R)
      • The access method is VTAM.
    ACQSTATUS(cvda)
  • Returns the same value as does the TERMSTATUS option and is retained only for compatibility purposes.
  • Use the TERMSTATUS option in new applications.
    ALTPAGEHT(data-area)
  • Returns a 16-bit binary field that gives the height (in lines) of the alternate page size.
  • See also DEFPAGEHT and PAGEHT.
    ALTPAGEWD(data-area)
  • Returns a 16-bit binary field that gives the width (in characters) of the alternate page size.
  • See also DEFPAGEWD and PAGEWD.
    ALTPRINTER(data-area)
  • Returns the four-character name of the alternative printer that is used for print key requests and ISSUE PRINT commands from tasks at this terminal when the printer that is named in the PRINTER option of the TERMINAL definition is not available.
    ALTPRTCOPYST(cvda)
  • Returns a CVDA value that indicates whether CICS is to use the hardware copy feature to satisfy a print request on the printer that is named in the ALTPRINTER option.
  • The CVDA values are:
    • ALTPRTCOPY
      • CICS is to use the hardware copy feature.
    • NOALTPRTCOPY
      • CICS is not to use the hardware copy feature.
  • TXSeries for Multiplatforms always returns this value.
    ALTSCRNHT(data-area)
  • Returns a 16-bit binary field that gives the height (in lines) of the alternate screen size.
  • See also DEFSCRNHT, SCREENHEIGHT, and SCRNHT.
    ALTSCRNWD(data-area)
  • Returns a 16-bit binary field that gives the width (in characters) of the alternate screen size.
  • See also DEFSCRNWD, SCREENWIDTH, and SCRNWD.
    ALTSUFFIX(data-area)
  • Returns the one-character suffix that BMS appends to map set names for maps that are written to this terminal when the screen is the alternative size and suffixing is in use.
    APLKYBDST(cvda)
  • Returns a CVDA value that indicates whether the terminal has the APL keyboard feature.
  • The CVDA values are:
    • APLKYBD
      • The terminal has the APL keyboard feature.
    • NOAPLKYBD
      • The terminal does not have the APL keyboard feature.
  • TXSeries for Multiplatforms always returns this value.
    APLTEXTST(cvda)
  • Returns a CVDA value that indicates whether the terminal has the APL text feature.
  • The CVDA values are:
    • APLTEXT
      • The terminal has the APL text feature.
    • NOAPLTEXT
      • The terminal does not have the APL text feature.
  • TXSeries for Multiplatforms always returns this value.
    ASCII(cvda)
  • Returns a CVDA value that indicates the type of ASCII code the terminal uses, if applicable.
  • The CVDA values are:
    • ASCII7
      • The code is 7-bit ASCII.
    • ASCII8
      • The code is eight-bit ASCII. TXSeries for Multiplatforms always returns this value.
    • NOTAPPLIC
      • The terminal does not use ASCII.
    ATISTATUS(cvda)
  • Returns a CVDA value of ATI or NOATI.
  • The ATI value indicates that the terminal is available for use by transactions that are automatically initiated from within CICS.
  • The NOATI value indicates that the terminal is in an intersystem communication (ISC) session, and it can be used by 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.
    AUDALARMST(cvda)
  • Returns a CVDA value that indicates whether the terminal has the 3270 audible alarm feature.
  • The CVDA values are:
    • AUDALARM
      • The terminal has the audible alarm feature.
      • TXSeries for Multiplatforms always returns this value.
    • NOAUDALARM
      • The terminal does not have the audible alarm feature.
    AUTOCONNECT(cvda)
  • Returns a CVDA value that indicates whether CICS is to attempt to establish a session with this terminal when CICS is initialized.
  • The CVDA values are:
    • ALLCONN
      • CICS binds the session.
    • AUTOCONN
      • CICS binds the session.
    • NONAUTOCONN
      • CICS does not bind a session.
      • For a local terminal definition, the value NONAUTOCONN is always returned.
    • NOTAPPLIC
      • The terminal is not a VTAM terminal, or it is a remote terminal, a surrogate, or a model.
    BACKTRANSST(cvda)
  • Returns a CVDA value that indicates whether the terminal has the 3270 background transparency feature.
  • Background transparency allows you to control whether the display area behind a character is clear (transparent) or shaded.
  • The CVDA values are:
    • BACKTRANS
      • The terminal has the background transparency feature.
    • NOBACKTRANS
      • The terminal does not have the background transparency feature.
  • TXSeries for Multiplatforms always returns this value.
    COLORST(cvda)
  • Returns a CVDA value that indicates whether the terminal has the 3270 extended color feature, which allows colors to be selected for individual fields or characters.
  • The CVDA values are:
    • COLOR
      • The terminal has the extended color feature.
    • NOCOLOR
      • The terminal does not have the extended color feature.
    COPYST(cvda)
  • Returns a CVDA value that indicates whether the control unit through which the terminal is attached includes the copy feature.
  • COPYST applies only to 3270 terminals.
  • The CVDA values are:
    • COPY
      • The control unit has the copy feature.
    • NOCOPY
      • The control unit does not have the copy featureTXSeries for Multiplatforms always returns this value.
    CREATESESS(cvda)
  • Returns a CVDA value that indicates whether CICS is to attempt to acquire the terminal if it is required for an automatic task initiation (ATI) request.
  • Only physical terminals can be acquired by CICS; sessions are not eligible.
  • The CVDA values are:
    • CREATE
      • The terminal can be acquired.
    • NOCREATE
      • The terminal cannot be acquired.
    • NOTAPPLIC
      • The terminal is not a terminal or is an APPC session.
  • The values NOCREATE or NOTAPPLIC are the only values that are returned.
    DATASTREAM(cvda)
  • Returns a CVDA value that indicates the type of data stream used by the terminal.
  • The CVDA values are:
    • DS3270
      • The terminal uses the 3270 data stream.
    • NOTAPPLIC
      • The terminal does not use either the 3270 or SCS data stream.
    • SCS
      • The terminal uses SNA character strings.
  • The values DS3270 or NOTAPPLIC are the only values that are returned with TXSeries for Multiplatforms.
    DEFPAGEHT(data-area)
  • Returns a 16-bit binary field that gives the height (in lines) of the default page size.
  • See also ALTPAGEHT and PAGEHT.
    DEFPAGEWD(data-area)
  • Returns a 16-bit binary field that gives the width (in characters) of the default page size.
  • See also ALTPAGEWD and PAGEWD.
    DEFSCRNHT(data-area)
  • Returns a 16-bit binary field that gives the height (in lines) of the default screen size.
  • See also ALTSCRNHT, SCREENHEIGHT, and SCRNHT.
    DEFSCRNWD(data-area)
  • Returns a 16-bit binary field that gives the width (in characters) of the default screen size.
  • See also ALTSCRNWD, SCREENWIDTH, and SCRNWD.
    DEVICE(cvda)
  • Returns a CVDA value that identifies the terminal or session type.
  • The following CVDA values apply to the DEVICE option:
    • Terminal type
      • CVDA
    • PM/fullscreen
      • T3277L, SBCS, or DBCS
    • Printer
      • T3284R, SBCS, or DBCS
    • Sequential terminal
      • SEQDISK
    • Remote or client terminal
      • T3277R
    • Session
      • LUTYPE6
  • Other values possibly can be returned for remotely attached terminals.
  • For a complete list of the CVDA symbolic names that are recognized by CICS, together with their associated numeric values, see Appendix F, CVDAs recognized by the translator.
    DEVICEST(cvda)
  • Returns a CVDA value that indicates whether the terminal, if it is a printer, is busy or not.
  • The CVDA values are:
    • BUSY
      • The terminal is busy.
    • NOTBUSY
      • The terminal is not busy or is not a printer.
    DISCREQST(cvda)
  • Returns a CVDA value that indicates whether CICS is to honor a request to disconnect the terminal.
  • Disconnect requests result from an ISSUE DISCONNECT command, or a CESF (sign-off) task with the GOODNIGHT or LOGOFF option.
  • The CVDA values are:
    • DISCREQ
      • CICS is to honor a request to disconnect this terminal.
      • TXSeries for Multiplatforms always returns this value.
    • NODISCREQ
      • CICS is not to honor a request to disconnect this terminal.
    DUALCASEST(cvda)
  • Returns a CVDA value that indicates whether the terminal has a typewriter keyboard or an operator console keyboard.
  • The CVDA values are:
    • DUALCASE
      • The terminal has a typewriter keyboard. TXSeries for Multiplatforms always returns this value.
    • NODUALCASE
      • The terminal has an operator console keyboard (this keyboard is not restricted to a single case), or it is not a 3270 display.
    EXITTRACING(cvda)
  • Returns a CVDA value indicating whether this terminal is to be traced when CICS VTAM exit tracing is active.
  • The CVDA values are:
    • EXITTRACE
      • The terminal is to be traced.
    • NOEXITTRACE
      • The terminal is not to be traced.
    • NOTAPPLIC
      • The terminal is not a VTAM terminal, or it is a remote terminal, a surrogate terminal, or a model definition.
  • The values NOEXITTRACE or NOTAPPLIC are the only values that are returned with TXSeries for Multiplatforms.
    EXTENDEDDSST(cvda)
  • Returns a CVDA value that indicates whether the terminal supports the 3270 extended data stream.
  • The CVDA values are:
    • EXTENDEDDS
      • The terminal supports the extended data stream.
    • NOEXTENDEDDS
      • The terminal does not support the extended data stream.
    FMHPARMST(cvda)
  • Returns a CVDA value that indicates whether BMS accepts user-supplied values for inclusion in a function management header (FMH) that is to be built by BMS.
  • This support is available only on 3650 terminals.
  • The CVDA values are:
    • FMHPARM
      • BMS allows user-supplied values.
    • NOFMHPARM
      • BMS does not allow user-supplied values.
      • TXSeries for Multiplatforms always returns this value.
    FORMFEEDST(cvda)
  • Returns a CVDA value that indicates whether the terminal has the forms-feed feature.
  • The CVDA values are:
    • FORMFEED
      • The terminal has the forms-feed feature.
    • NOFORMFEED
      • The terminal does not have the forms-feed feature.
      • TXSeries for Multiplatforms always returns this value.
    GCHARS(data-area)
  • Returns a 16-bit binary field that indicates the Graphic Character Set Global Identifier (GCSGID).
  • The value is a number in the range 1 through 65534, as specified in the Terminal Definitions (WD).
  • It represents the set of graphic characters that can be input or output at the terminal.
  • If the task is not initiated from a terminal, an INVREQ condition occurs.
  • This option always returns zero for CICS local terminals.
  • Surrogate terminals that have been transaction-routed from non-CICS systems have an appropriate value returned.

  • Note:
    • The term Graphic Character Set Global Identifier (GCSGID) refers to the five-digit decimal identifier that is assigned to a graphic character set.
    • The range of GCSGID values is 00001 through 65534 (X'0001' through X'FFFE').
    • The term Code Page Global Identifier (CPGID) refers to the number that is assigned to a registered code page or pages, such as 00500.
    • The term Coded Graphic Character Set Identifier (CGCSI) refers to the ten-digit decimal identifier that consists of the concatenation of a Graphic Character Set Global Identifier (GCSGID) and a Code Page Global Identifier (CPGID).
    • This is the same as referring to concatenation of GCODES.
    GCODES(data-area)
  • Returns a 16-bit binary field that indicates the Code Page Global Identifier (CPGID).
  • The value is a number in the range 1 through 65534, as specified in the WD.
  • It represents the code page that defines the code points for the characters that can be input or output at the terminal.
  • If the task is not initiated from a terminal, an INVREQ condition occurs.
  • This option always returns zero for CICS local terminals.
  • Surrogate terminals that have been transaction-routed from non-CICS systems have an appropriate value returned.
  • See note included with the GCHARS option.
    HFORMST(cvda)
  • Returns a CVDA value that indicates whether the terminal has the horizontal forms feature, which is required for use of horizontal tabbing when documents for output are being formatted.
  • The CVDA values are:
    • HFORM
      • The terminal has the horizontal forms feature.
    • NOHFORM
      • The device does not have the horizontal forms feature.
      • TXSeries for Multiplatforms always returns this value.
    HILIGHTST(cvda)
  • Returns a CVDA value that indicating whether the terminal has the 3270 extended highlighting facility, which enables fields or characters to be displayed in reverse-video, underlined, or blinking.
  • The CVDA values are:
    • HILIGHT
      • The terminal has extended highlighting.
    • NOHILIGHT
      • The terminal does not have extended highlighting.
    KATAKANAST(cvda)
  • Returns a CVDA value that indicates whether the terminal is a Katakana terminal.
  • The CVDA values are:
    • KATAKANA
      • The terminal is a Katakana terminal.
    • NOKATAKANA
      • The terminal is not a Katakana terminal.
    LIGHTPENST(cvda)
  • Returns a CVDA value that indicates whether the terminal has the 3270 selector pen feature.
  • The CVDA values are:
    • LIGHTPEN
      • The terminal has the selector pen feature.
    • NOLIGHTPEN
      • The terminal does not have the selector pen feature.
      • TXSeries for Multiplatforms always returns this value.
    MAPNAME(data-area)
  • Returns the seven-character name of the map that was most recently referenced in the MAP option of a SEND MAP command that was processed for this terminal.
  • If this terminal is a surrogate, the map name possibly can be the last map that was sent by the terminal-owning region (TOR) or another application-owning region (AOR) in which this terminal has been represented as a surrogate device.
  • If the terminal is not supported by BMS (for example, this terminal is a session), or CICS has no record of any map being sent, a null value is returned.
  • If a CONVERSE, SEND, SEND TEXT, or SEND CONTROL command has been issued, or the CLEAR key has been pressed since the SEND MAP command was issued, the MAPNAME value is no longer valid.
    MAPSETNAME(data-area)
  • Returns the eight-character name of the mapset that was most recently referenced in the MAPSET option of a SEND MAP command that was processed for this terminal.
  • If the MAPSET option was not specified on the most recent request, BMS uses the map name as the mapset name.
  • If this terminal is a surrogate, the mapset name possibly can be the last mapset that was used by the terminal owning region or another AOR in which this terminal has been represented as a surrogate device.
  • If the terminal is not supported by BMS (for example this terminal is a session), or CICS has no record of any mapset being used, a null value is returned.
  • If a CONVERSE, SEND, SEND TEXT, or SEND CONTROL command has been issued, or the CLEAR key has been pressed since the SEND MAP command was issued, the MAPSETNAME value is no longer valid.
    MODENAME(data-area)
  • (APPC only) Returns the eight-character name of the session group to which the session about which you are inquiring belongs.
  • The MODENAME option applies only to APPC sessions; for other types, a null value is returned.
    MSRCONTROLST(cvda)
  • Returns a CVDA value that indicates whether the terminal has a magnetic slot reader.
  • This feature is available only on 8775 and 3643 terminals.
  • The CVDA values are:
    • MSRCONTROL
      • The terminal has a magnetic slot reader.
    • NOMSRCONTROL
      • The terminal does not have a magnetic slot reader.
      • TXSeries for Multiplatforms always returns this value.
    NATLANG(data-area)
  • Returns a one-character value that gives the national language that is specified in the terminal definition.
  • This value cannot be changed by any command, and is not necessarily the same as the national language that is currently in use at the terminal.
  • Possible values are:
    • E
      • English
    • K
      • Katakana
    • blank
      • No value specified
    NATURE(cvda)
  • Returns a CVDA value that identifies the nature of the terminal definition.
  • The CVDA values are:
    • MODEL
      • A model terminal definition that is used only to build definitions of real terminals.
    • SESSION
      • A session.
    • SURROGATE
      • A surrogate terminal definition that represents a terminal that is owned by another CICS region.
    • TERMINAL
      • A physical terminal definition.
    NETNAME(data-area)
  • Returns an eight-character string that represents the name of the logical unit in the network that is associated with the terminal that is named on an INQUIRE TERMINAL command.

  • Note:
    • This description applies to the NETNAME option that is in an INQUIRE TERMINAL command.
    • In an INQUIRE NETNAME command, the roles of NETNAME and TERMINAL are reversed.
    • The NETNAME value specifies the name of the terminal or session about which you are inquiring to CICS, rather than returning information, and the TERMINAL option returns the corresponding terminal identifier, if you use it.
    NETNAME(name)
  • Specifies, on an INQUIRE NETNAME command, the eight-character netname for which information is being requested.
  • Either TERMINAL or NETNAME must be the first option that is used as an input field.
  • The value that you supply is used as the search argument.
  • Whichever is specified first, the other can be optionally specified as the second option; the latter is always an output field.
    NEXTTRANSID(data-area)
  • Returns the four-character identifier of the transaction that is to be executed in order to process the next unsolicited input from this terminal.
  • This is the value that is set in the TRANSID option of an EXEC CICS RETURN command, or the NEXTTRANSID option of an EXEC CICS SET TERMINAL command.
    OBFORMATST(cvda)
  • Returns a CVDA value that indicates whether outboard formatting can be used for this terminal.
  • The CVDA values are:
    • NOOBFORMAT
      • This terminal does not support outboard formatting.
      • TXSeries for Multiplatforms always returns this value.
    • OBFORMAT
      • This terminal supports outboard formatting.
    OBOPERIDST(cvda)
  • Returns a CVDA value that indicates whether CICS uses outboard operator identifiers to support the BMS routing facilities at this terminal.
  • This option applies only to the 3790 and 3770 batch data interchange logical units.
  • The CVDA values are:
    • NOOBOPERID
      • CICS does not use outboard operator identifiers.
      • TXSeries for Multiplatforms always returns this value.
    • OBOPERID
      • CICS uses outboard operator identifiers.
    OPERID(data-area)
  • Returns, in a three-byte area, the operator identification that is specified in the OPID field in the User Definitions (UD) entry for the user who is signed on to the terminal.
  • If the task is not initiated from a terminal, an INVREQ condition occurs.

  • Note:
    • If the terminal is a surrogate terminal, this value is possibly not current; it represents the user who is signed on at the time the terminal definition was shipped from the owning CICS region to this one.
    • It is possible that user has since signed off.
    OUTLINEST(cvda)
  • Returns a CVDA value that indicates whether the terminal has the 3270 field outlining feature.
  • The CVDA values are:
    • NOOUTLINE
      • The terminal does not support field outlining.
    • OUTLINE
      • The terminal supports field outlining.
    PAGEHT(data-area)
  • Returns a 16-bit binary field that gives the height (in lines) of the current page size for the terminal.
  • See the DEFPAGEHT and ALTPAGEHT options.
    PAGESTATUS(cvda)
  • Returns a CVDA value that indicates how pages of BMS messages with a disposition of PAGING need to be delivered to the terminal.
  • The CVDA values are:
    • AUTOPAGEABLE
      • Pages are written automatically in sequence.
    • PAGEABLE
      • Pages are written on request from the operator.
      • TXSeries for Multiplatforms always returns this value.
    PAGEWD(data-area)
  • Returns a 16-bit binary field that gives the width (in characters) of the current page size for the terminal.
  • See also DEFPAGEWD and ALTPAGEWD.
    PARTITIONSST(cvda)
  • Returns a CVDA value that indicates whether the terminal supports partitions.
  • The CVDA values are:
    • NOPARTITIONS
      • The terminal does not support partitions.
      • TXSeries for Multiplatforms always returns this value.
    • PARTITIONS
      • The terminal supports partitions.
    PRINTADAPTST(cvda)
  • Returns a CVDA value that indicates whether the terminal has the printer adapter feature.
  • The CVDA values are:
    • NOPRINTADAPT
      • The terminal does not have a printer adapter.
      • TXSeries for Multiplatforms always returns this value.
    • PRINTADAPT
      • The terminal has a printer adapter.
    PRINTER(data-area)
  • Returns the four-character name of the preferred printer for print key requests and ISSUE PRINT commands from tasks at this terminal.
  • This printer is used if available; if not, the printer that is named in the ALTPRINTER option is second choice.
    PROGSYMBOLST(cvda)
  • Returns a CVDA value that indicates whether the terminal supports the 3270 programmed symbol feature, which enables the terminal to use multiple character sets.
  • The CVDA values are:
    • NOPROGSYMBOL
      • The terminal does not support programmable symbols.
      • TXSeries for Multiplatforms always returns this value.
    • PROGSYMBOL
      • The terminal supports programmable symbols.
    PRTCOPYST(cvda)
  • Returns a CVDA value that indicates whether CICS is to use the hardware copy feature to satisfy a print request on the printer that is named on the PRINTER option.
  • The CVDA values are:
    • NOPRTCOPY
      • CICS is not to use the hardware copy feature.
      • TXSeries for Multiplatforms always returns this value.
    • PRTCOPY
      • CICS is to use the hardware copy feature.
    QUERYST(cvda)
  • Returns a CVDA value that indicates whether and when CICS is to use a QUERY structured field to determine the characteristics of the terminal.
  • The CVDA values are:
    • ALLQUERY
      • The terminal is to be queried each time it is connected.
    • COLDQUERY
      • The terminal is to be queried only when it is first connected after a cold start of CICS.
    • NOQUERY
      • The terminal is not to be queried.
      • TXSeries for Multiplatforms always returns this value.
    RELREQST(cvda)
  • Returns a CVDA value that indicates whether CICS is to honor requests from VTAM to release the terminal or session.
  • The CVDA values are:
    • NORELREQ
      • CICS cannot release the logical unit, or the access method is not VTAM.
      • TXSeries for Multiplatforms always returns this value.
    • RELREQ
      • CICS can release the logical unit.
    REMOTENAME(data-area)
  • Returns the four-character name of this terminal in the remote CICS region in which it is defined.
  • The REMOTENAME option applies only to terminals that are defined as remote; for others, a null value is returned.
    REMOTESYSTEM(data-area)
  • Returns a four-character string that represents the name of the associated remote system, if the subject of the inquiry is an APPC session.
  • If the subject of the inquiry is a remote terminal, the REMOTESYSTEM option returns the name of the link to the terminal-owning system.
    SCREENHEIGHT(data-area)
  • Returns a 16-bit binary field that indicates the height of the current screen in lines.
  • Note:
    • The SCRNHT option is a synonym for the SCREENHEIGHT option of earlier releases of CICS.
    • For compatibility, CICS recognizes the SCREENHEIGHT option as equivalent.
    SCREENWIDTH(data-area)
  • Returns a 16-bit binary field that indicates the width of the current screen in characters.
  • Note:
    • The SCRNWD option is a synonym for the SCREENWIDTH option of earlier releases of CICS.
    • For compatibility, CICS recognizes the SCREENWIDTH option as equivalent.
    SCRNHT(data-area)
  • Returns a 16-bit binary field that gives the height (in lines) of the current screen size.
  • See also DEFSCRNHT and ALTSCRNHT.
  • Note:
    • The SCRNHT option is a synonym for the SCREENHEIGHT option of earlier releases of CICS.
    • For compatibility, CICS recognizes the SCREENHEIGHT option as equivalent.
    SCRNWD(data-area)
  • Returns a 16-bit binary field that gives the current width of the terminal screen (in characters).
  • See the DEFSCRNWD and ALTSCRNWD options.
  • Note:
    • The SCRNWD option is a synonym for the SCREENWIDTH option of earlier releases of CICS.
    • For compatibility, CICS recognizes the SCREENWIDTH option as equivalent.
    SECURITY(cvda)
  • Returns a CVDA value that indicates whether the terminal has preset security.
  • The CVDA values are:
    • NOPRESETSEC
      • The terminal does not have preset security.
      • TXSeries for Multiplatforms always returns this value.
    • PRESETSEC
      • The terminal has preset security.
    SERVSTATUS(cvda)
  • Returns a CVDA value that indicates whether the terminal is enabled, disabled, or going out-of-service.
  • The CVDA values are:
    • INSERVICE
      • The terminal is enabled.
    • OUTSERVICE
      • The terminal is disabled.
    • GOINGOUT
      • The terminal is to be put in OUTSERVICE status when some current work has completed.
      • The terminal is not available to new tasks.
    SESSIONTYPE(cvda)
  • Returns a CVDA value that identifies the type of the session about which you are inquiring.
  • This option applies only to APPC sessions.
  • The CVDA values are:
    • APPCPARALLEL
      • This is a parallel APPC session group.
    • APPCSINGLE
      • This is a single APPC session.
    • NOTAPPLIC
      • The terminal is not one of the above.
      • TXSeries for Multiplatforms always returns this value.
    SIGNONSTATUS(cvda)
  • Returns a CVDA value that indicates whether the terminal currently has a signed-on user.
  • The CVDA values are:
    • SIGNEDOFF
      • The terminal does not have a signed-on user.

    • SIGNEDON
      • The terminal has a signed-on user.
    SOSIST(cvda)
  • Returns a CVDA value that indicates whether the terminal supports mixed EBCDIC and double-byte character set (DBCS) fields.
  • The CVDA values are:
    • NOSOSI
      • The terminal does not support mixed field.
    • SOSI
      • The terminal supports mixed fields.
    TASKID(data-area)
  • Returns a 32-bit binary field that gives the number of the user task that is currently running at this terminal.
  • The value zero is returned if no task is using the terminal.
    TCAMCONTROL(data-area)
  • Returns a one-character TCAM control byte that indicates which segment of a message has passed between CICS and TCAM.
  • The value x'FF' is always returned.
    TERMINAL(data-area)
  • Returns a four-character string that represents the name of the terminal that is associated with the netname that is specified on an INQUIRE NETNAME command.
    TERMINAL(name)
  • Specifies, on an INQUIRE TERMINAL command, the four-character name of the terminal as defined in the Terminal Definitions (WD).
  • See NETNAME(name).
    TERMMODEL(data-area)
  • Returns a 16-bit binary field that indicates the terminal model number (10 for 3278, or 1 for 3270 model 2).
    TERMPRIORITY(data-area)
  • Returns a 32-bit binary field that indicates the priority of the terminal relative to other terminals, in the range 0 through 255.
    TERMSTATUS(cvda)
  • Returns a CVDA value that indicates the state of the terminal.
  • The exact state depends upon how the terminal definition has been created with the CICS region.
  • The CVDA values are:
    • ACQUIRED
      • The terminal is connected to the region.
    • ACQUIRING
      • The terminal is in the process of autoinstalling.
    • NOTAPPLIC
      • This value is never returned.
    • RELEASED
      • The terminal has been defined in the region database but has not yet been connected to the region or the terminal has been connected to the region but can no longer be contacted.
    • RELEASING
      • The terminal is in the process of uninstalling.
    TEXTKYBDST(cvda)
  • Returns a CVDA value that indicates whether the terminal has the 3270 text-keyboard feature.
  • The CVDA values are:
    • NOTEXTKYBD
      • The terminal does not have the text-keyboard feature.
      • TXSeries for Multiplatforms always returns this value.
    • TEXTKYBD
      • The terminal has the text-keyboard feature.
    TEXTPRINTST(cvda)
  • Returns a CVDA value that indicates whether the terminal has the 3288 text-print feature.
  • The CVDA values are:
    • NOTEXTPRINT
      • The terminal does not have the text-print feature.
      • TXSeries for Multiplatforms always returns this value.
    • TEXTPRINT
      • The terminal has the text-print feature.
    TRACING(cvda)
  • Returns a CVDA value that indicates the type of tracing that is defined for this terminal.
  • The CVDA values are:
    • SPECTRACE
      • Special tracing is specified.
    • STANTRACE
      • Standard tracing is specified.
      • TXSeries for Multiplatforms always returns this value.
    TRANSACTION(data-area)
  • Returns a four-character string that represents the name of the transaction that is currently executing with the named terminal as its principal facility.
    TTISTATUS(cvda)
  • Returns a CVDA value of TTI or NOTTI that indicates whether the terminal is available for use by transactions that are initiated from this terminal.
  • A terminal cannot have both NOATI and NOTTI in its status.
    UCTRANST(cvda)
  • Returns a CVDA value that indicates whether input from this terminal is translated to uppercase characters automatically, at the time of receipt.
  • Translation can be suppressed, but only in a conversational task, when input is solicited with a RECEIVE or CONVERSE ASIS command.
  • This value comes from the Upper Case Translation option of the Terminal Control Table (TCT) definition.
  • The CVDA values are:
    • NOUCTRAN
      • Input from this terminal is not translated to uppercase characters on receipt.
    • TRANIDONLY
      • This value is the same as NOUCTRAN, with one difference.
      • If the input is unsolicited and CICS needs to use the initial characters of the input to decide which transaction to execute, that decision is made from a copy of the input that has been translated to uppercase characters.
      • No difference exists in the data that is presented to the task between these two options.
    • UCTRAN
      • The input is translated to uppercase characters on receipt.
    USERAREA(ptr-ref)
  • Returns a pointer reference that is set to the address of the Terminal User Area (TCTUA).
  • If no TCTUA exists, the address returned is X'FF000000'.
    USERAREALEN(data-area)
  • Returns a 16-bit binary field that indicates the length of the user area.
  • Zero is returned if no user area exists.
    USERID(data-area)
  • Returns an eight-character string that represents the security code that identifies the person who is signed on, as defined in the User Definitions (UD).
  • A null value is returned if no user is signed on.
    USERNAME(data-area)
  • Returns the 20-character name of the user who is signed on at this terminal or session (that is, the name that corresponds to the USERID option value).
  • If the information, which is provided by the external security manager, is shorter than 20 bytes, CICS pads it to 20 bytes with trailing blanks.
  • A null value is returned if no user is signed on.
    VALIDATIONST(cvda)
  • Returns a CVDA value that indicates whether the device has the extended validation feature, which allows you to request special processing of keyboard input, in addition to the normal 3270 function.
  • This feature is available only on 8775 and 3290 terminals.
  • The CVDA values are:
    • NOVALIDATION
      • The terminal does not have the extended validation feature or is a model terminal.
      • TXSeries for Multiplatforms always returns this value.
    • VALIDATION
      • The terminal has the extended validation feature.
    VFORMST(cvda)
  • Returns a CVDA value that indicates whether the terminal has the vertical forms feature, which is required for use of vertical tabbing when formatting documents for output.
  • The CVDA values are:
    • NOVFORM
      • The device does not have the vertical forms feature.
      • TXSeries for Multiplatforms always returns this value.
    • VFORM
      • The terminal has the vertical forms feature.
    ZCPTRACING(cvda)
  • (VTAM only) - Returns a CVDA value that indicates whether this terminal is to be traced when CICS tracing for VTAM terminals is turned on.
  • The CVDA values are:
    • NOTAPPLIC
      • The terminal is not a VTAM terminal, or it is a surrogate terminal or a model definition.
    • NOZCPTRACE
      • The terminal is not to be traced.
    • ZCPTRACE
      • The terminal is to be traced.
      • TXSeries for Multiplatforms never returns this value.

Condições:

    END
  • No more resource definitions of this type (RESP2=2) exist.
    ILLOGIC
  • You have issued a START command when a browse of this resource type is already in progress, or you have issued a NEXT or an END command when a browse of this resource type is not in progress (RESP2=1).
    TERMIDERR
  • Occurs if the named terminal or netname cannot be found in the WD (RESP2=1).
  • Ação pré-definida: Terminates the task abnormally.

Informações relacionadas:

© Copyright IBM Corp.