TERMNLAggregateRecordType

Indicates whether CICS can initiate a task automatically (ATI) with this terminal as its principal facility.

Input Values: ATI, NOATI

Indicates whether this terminal can be used by transactions initiated from this terminal. The options are TTI or NOTTI

The access method defined for the terminal as one of the following:

• VTAM
• BSAM
• BTAM
• BGAM
• TCAM
• TCAMSNA
• CONSOLE

Under VTAM, indicates whether CICS is in session with the logical unit represented by this terminal. If this field is NOTAPPLIC, it means the access method is something other than VTAM. Input Values:

• ACQUIRED
• RELEASED
• NOTAPPLIC
• COLDACQ
• ACQUIRING
• RELEASING

The alternate page height defined for use by BMS when the alternate page size is selected.

The alternate page width defined for use by BMS when the alternate page size is selected.

The name of a 3270 printer for use as an alternative to the preferred printer.

Indicates whether CICS is to use the hardware COPY feature to satisfy a print request from the alternate printer.

Input Values: ALTPRTCOPY, NOALTPRTCOPY

The alternate screen height defined for use by BMS when the alternate screen size is selected.

The alternate screen width defined for use by BMS when the alternate screen size is selected.

A 1-character numeric suffix that BMS appends to map set names, as specified on the DFHMSD TYPE macro. If this field is blank, it means that no suffix is added to map set names. This applies only when the screen has the alternate size and suffixing is in use.

Indicates whether the 3270 device has the APL keyboard feature. Values are APLKYBDS or NOAPLKYB.

Indicates whether the 3270 device has the APL text feature. Values are APLTEXT or NOAPLTEX.

Identifies the type of ASCII data stream being used.

• ASCII7 - A 7-bit ASCII datastream.
• ASCII8 - An 8-bit ASCII datastream.
• NOTAPPLIC - Not applicable.

Indicates whether the device has the audible alarm feature for a 3270 display or a 3270 printer attached to a 3651 controller (AUDALARM or NOAUDALARM).

Identifies whether sessions with this terminal are to be established when CICS is initialized or whenever communication with VTAM is started.

• ALLCONN - Same as AUTOCONN
• AUTOCONN - CICS binds associated sessions.
• NONAUTOCONN - CICS does not bind associated sessions.
• NOTAPPLIC - The terminal is not a VTAM terminal, or is a remote terminal, a surrogate, or a model.

Indicates whether the device has the background transparency feature (BACKTRANS or NOBACKTRANS).

Indicates whether the device has the extended color feature, which allows colors to be chosen for each field or character (COLOR or NOCOLOR).

Indicates, for an MVS console only, the identifier for the console.

Indicates whether the copy feature for a 3270 display or printer is included in the 3270 control unit (COPY or NOCOPY).

The 8-character correlation-id, as follows:

• For LU6.1 sessions, NETNAMEQ.
• .For LU6.2 sessions, a token that is common to the two connected sessions.
• .For MRO sessions, the terminal ID of the session at the other end of the MRO link to which this session is connected.

Identifies the device data stream type:

• DS3270 - 3270 Datastream
• NOTAPPLIC - Not applicable
• SCS - SNA character strings

The default page height defined for use by BMS when the default page size is selected.

The default page width defined for use by BMS when the default page size is selected.

The default screen height defined for use by BMS when the default screen size is selected.

The default screen width defined for use by BMS when the default screen size is selected.

The terminal or session type as recorded in the TCTTE.

Possible values: BATCHLU, BIPROG, BISYNCH, CDRDLPRT, CONTNLU, HARDCOPY, INTACTLU, ISCMMCONV, LUCMODGRP, LUCSESS, LUTYPE4, LUTYPE6, MAGTAPE, RESSYS, SDLC, SEQDISK, SYSTEM3, SYSTEM7, SYS7BSCA, TCONSOLE, TELETYPE, TTCAM, TWX3335, T1050, T1053, T2260L, T2260R, T2265, T2740, T2741BCD, T2741COR, T2770, T2780, T3275R, T3277L, T3277R, T3284L, T3284R, T3286L, T3286R, T3600BI, T3601, T3614, T3650ATT, T3735, T3650PIPE, T3650USER, T3653HOST, T3740, T3780, T3790, T3790SCSP, T3790UP, T7770, VIDEOTERM

Indicates whether CICS is to honor disconnect requests from an application.

Input Values: DISCREQ, NODISCREQ, NOTAPPLIC

Indicates whether the terminal has a typewriter keyboard or an operator console keyboard. Values are:

• DUALCASE - The terminal has a typewriter keyboard.
• NODUALCASE - The terminal has an operator console keyboard (this keyboard is not restricted to a single case), or is not a 3270 display.

Under VTAM, indicates whether exit tracing is active for the terminal. A value of NOTAPPLIC means the access method is something other than VTAM.

Input Values: EXITTRACE, NOEXITTRACE

Indicates whether the 3270 device or SCS printer supports extensions to the 3270 data stream. The options are EXTENDEDDS or NOEXTENDEDDS.

Indicates whether the device supports function management header (FMH) data built by BMS from user-supplied parameters. The options are FMHPARM or NOFMHPARM.

Indicates whether the device has the forms feed feature. The options are FORMFEED and NOFORMFEED.

The graphic character set global ID (GCSGID). This ID is a registered number in the range 1 - 65534 that identifies the set of graphic characters that can be input or output at this terminal. A value of zero means no GCSGID value was defined.

The code page global ID (CPGID). This ID is a registered number in the range 1 - 65534 that identifies the EBCDIC code page that defines the code points for the characters that can be input or output at this terminal. A value of zero means no CPGID value was defined.

Indicates whether the device has the horizontal forms feature, which enables BMS to use horizontal tabbing when formatting documents for output. The options are HFORM or NOHFORM.

Indicates whether the 3270 device or SCS printer has the extended highlight facility, which enables fields or characters to be displayed in reverse-video, underline mode, or blinking. The options are HILIGHT or NOHILIGHT.

The number of operator-initiated inputs to the terminal, including initial transaction input and input as a result of a conversational read to the terminal.

Indicates whether the device is a Katakana terminal (KATAKANA or NOKATAKANA).

Indicates whether a 3270 display has the selector pen feature. The options are LIGHTPEN or NOLIGHTPEN.

For remote terminals only, the 4-character name of the connection that is the real link towards the TOR.

The name of the BMS map that was most recently referenced in the MAP option of a SEND MAP command processed for this terminal.

The name of the BMS map set that was most recently referenced in the MAPSET option of a SEND MAP command processed for this terminal.

Under APPC, the name of a group of parallel sessions (to which this terminal belongs) that have similar characteristics.

Indicates whether the terminal is an 8775 or 3643 device with a magnetic slot reader. The options are MSRCONTR or NOMSRCON.

The terminal name as specified in the installed terminal definition.

A 1-character alphanumeric value that identifies the national language originally defined for use with this terminal.

Indicates the nature of the terminal definition as one of the following:

• TERMINAL - Physical terminal definition
• MODEL - Model terminal definition, specific to a type of terminal
• SESSION - Remote (APPC) session
• SURROGAT - Surrogate terminal definition

Under VTAM, the name by which this logical unit (either a terminal or a session) is known. If this field is blank, it means the access method is something other than VTAM.

The name of the next transaction to run after an EXEC CICS RETURN command.

Input Values: Any valid transaction ID

The network qualified name if one was sent by VTAM at logon time.

Indicates whether the device supports outboard formatting.

Input Values: OBFORMAT, NOOBFORMAT

For 3790 and 3770 batch data interchange logical units, indicates whether outboard operator IDs are used by CICS to support the BMS routing facilities required for this terminal (OBOPERID or NOOBOPERID).

Returns the 3-character operator identification code of the user signed on at the terminal.

Note: If the terminal is a surrogate terminal, this value may not be current; it represents the user signed on at the time the terminal definition was shipped from the owning CICS region to this one, who may since have signed off. The OPERID may also be different from that of the user currently signed on if it has been changed with the SET TERMINAL command.

Indicates whether the device supports field outlining. The options are OUTLINE or NOOUTLINE.

The number of output messages written to the terminal by either an application program or CICS.

The page height currently in use for the device.

Indicates whether pages after the first in a series are written to the terminal automatically or on request from the operator.

Input Values: AUTOPAGEABLE, PAGEABLE

The page width currently in use for the device.

Indicates whether the device can use partitions (PARTITIONS or NOPARTITIONS).

The total throwaway count. A throwaway occurs when input is received for a pipeline pool terminal and none are available.

The maximum number of throwaways. A throwaway occurs when input is received for a pipeline pool terminal and none are available.

The number of consecutive throwaways. A throwaway occurs when input is received for a pipeline pool terminal and none are available.

Under TCAM or BSAM, the number of polls that have been sent to the terminal. If this field is blank, it means the access method is something other than TCAM or BSAM.

Indicates whether the device supports a printer adaptor feature (PRINTADAPT or NOPRINTADAPT).

The name of the preferred printer CICS is to use in response to a print request from this device.

Input Values: Any valid printer ID

Indicates whether the programmed symbol facility can be used on this 3270 device of SCS printer. The options are PROGSYMBOL or NOPROGSYMBOL .

Indicates whether CICS is to use the hardware COPY feature to satisfy a print request from the preferred printer.

Input Values: PRTCOPY, NOPRTCOPY

Indicates whether the device supports the use of the QUERY structured field to determine its characteristics:

• ALLQUERY - The QUERY function is supported each time the device is connected.
• COLDQUERY - The QUERY function is supported only when the device is first connected after a cold start of CICS.
• NOQUERY - The QUERY function is not supported.

Indicates whether CICS is to honor release requests from VTAM for the logical unit.

Input Values: RELREQ, NORELREQ, NOTAPPLIC

The 4-character name of this terminal in the remote CICS region in which it is defined. REMOTENAME applies only to terminals defined as remote; for others the value returned is blanks

For remote terminals only, the 8-character netname of the owning TOR.

returns the 4-character name of a connection or the first 4 characters of an IPCONN name.

The named connection can be either a connection entry that that links towards the TOR, or an indirect connection that provides the netname of the TOR.

For IPIC connections, the first 4 characters of the IPCONN name on the IPCONN definition which is in service and acquired is used.

The height of the current 3270 screen, which is either the ALTSCRNHT or DEFSCRNHT value.

The width of the current 3270 screen, which is either the ALTSCRNWD or DEFSCRNWD value.

Indicates whether the terminal has preset security (PRESET or NOPRESET).

Indicates whether the terminal is currently in service, out of service, or in the process of going out of service. The options are GOINGOUT, INSERVICE, OUTSERVICE

Under VTAM, indicates whether the terminal can be acquired automatically by ATI transactions. If this field is NOTAPPLIC, it means the access method is something other than VTAM. The options are CREATE, NOCREATE, NOTAPPLIC.

For terminals that are acting as sessions with another CICS system, the type of session as one of the following:

• LU61 - An LUTYPE6.1 session.
• APPCSINGLE - A single APPC session.
• APPCPARALLEL - A parallel APPC session group.
• NOTAPPLIC - The terminal is not one of the above.

Indicates whether the terminal currently has a signed on user (SIGNEDON or SIGNEDOFF).

Indicates whether the device supports mixed EBCDIC and double-byte character set (DBCS) fields. The options are SOSI or NOSOSI.

The number of storage violations that have occurred on the terminal.

The average TIOA storage allowed at this terminal.

The ID of the user task currently executing at this terminal.

Returns a 1-character TCAM control byte giving one of the following codes to identify which segment of a message has passed between CICS and TCAM. The meanings are:

• 00 Null
• 40 Intermediate part of message
• F1 First part of message
• F2 Last part of message
• F3 Whole message
• F4 Intermediate part of message, end of record
• F5 First part of message, end of record
• F6 Last part of message, end of record
• F7 Whole message, end of record
• FE TCAM is not active
• FF Not applicable (non-TCAM terminal)

The terminal model number, as specified in the TYPETERM definition. A value of N/A means this terminal is an LU6.2 or MRO session.

The priority of the terminal relative to other terminals.

Input Values: 0 - 255.

The type of terminal.

The number of transactions associated with the terminal that could not be started.

Indicates whether the 3270 device has the text keyboard feature. The options are TEXTKYBD or NOTEXTKYBD.

Indicates whether a 3288 printer has the text-print feature. The options are TEXTPRINT or NOTEXTPRINT.

The client TN3270 IPv4 or IPv6 address. If TNIPFAMILY returns NOTAPPLIC, TNADDR returns blanks.

The hostname used by the TN3270 client connection.

Identifies the address format of the TNADDR option.

• IPV4 - a dotted decimal IPv4 address.
• IPV6 - a colon hexadecimal IPv6 address.
• NOTAPPLIC - Not applicable.

The port number used for a TN3270 client connection. If the terminal is not a 3270 device, TNPORT returns zero.

Describes the tracing activity associated with the terminal as either standard or special. The options are STANTRACE or SPECTRACE.

The number of transactions, both nonconversational and pseudoconversational, that were started at the terminal.

The name of the transaction currently executing with this terminal as its principal facility.

Indicates whether the upper case translate option is supported for transactions associated with this terminal. The options are UCTRAN, NOUCTRAN, TRANIDONLY.

The 8-character identifier of the user signed on at this terminal or session. If there is no signed-on user, the value will be the default user ID, as specified in the DFLTUSER system initialization parameter.

The address of the user area.

The length of the user area.

returns the 20-character name of the user signed on at this terminal or session (that is, the name corresponding 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 with trailing blanks. Blanks are returned if there is no signed on user.

Indicates whether the device has the extended validation feature. The options are VALIDATION or NOVALIDATION.

Indicates whether the device has the vertical form feature, which enables BMS to use vertical tabbing when formatting documents for output (VFORM or NOVFORM).

The number of errors recorded if this is a terminal or the number of disconnects if this is an EXCI session.

Under VTAM, controls the tracing activity associated with the VTAM control component of CICS. A value of NOTAPPLIC means the access method is something other than VTAM. The options are ZCPTRACE or NOZCPTRACE.