1. Application Runtime for CICS Reference Guide
  2. CICS Runtime Configuration Files
  3. System Configuration File
  4. Specify GMTEXT

3.12.3 Specify GMTEXT

See this example to specify GMTEXT.

Listing Example of Specifying GMTEXT 

[KIXR]
APPLID=DBDCKIXR
GMTEXT='An Information Development CICS Terminal'

GMTEXT has the following two formats.

  • Mainframe CICS format

    The whole message must be enclosed by a pair of single delimiting apostrophes. You can use apostrophes as punctuation in your text; to do that, you must code two successive apostrophes to represent a single apostrophe.

    For example: GMTEXT='User''s logon message text.'
  • ART for CICS format

    Apostrophe does not act as an escape character. (This way is an easier way to edit your message.)

    For example: GMTEXT=User's logon message text.

Table 3-10 System Parameters

Field Name Type Values Description
SYSIDNT X(4) Mandatory Name of a system section to define a CICS region. The length of name is 1 - 4 characters. The default name is CICS.

The name of a system section and that of the defined CICS region should be the same.

Note:

If more than one sections share a same SYSIDNT, the final configuration for this CICS region will possess all the parameters defined in these sections. If a parameter is defined more than once in these sections, only the last one will make sense.
APPLID X(8) DBDCCICS|a pplid, Optional Identifies the CICS region in the VTAM network. The length of name is 1 - 8 characters. The default value is DBDCCICS.
INITPARM X(60) Mandatory Specifies initialization parameters in system initialization table (SIT) for each CICS application program that invokes ASSIGN INITPARM. The INITPARM format is INITPARM=(pgmname_1='parmstring_1'[,...,pgmname_n='parmstring_n']). We now support at most 255 sets of program=’parmstring’.

The value of program should consist of 1 - 8 alphanumeric characters and will be truncated if exceeding the length limit.

The value of parmstring should be at most 60 characters and will be truncated if exceeding the length limit. Parameter string should be enclosed by single quotes; any quotes imbedded in the string must be duplicated.

Note:

In each section, if INITPARM parameters are specified more than one time, only the last definition will take effect.
LGNMSG X(3) NO | YES, Optional A system initialization parameter which specifies whether logon data is available to an application program.
GMTEXT X(246 ) Optional GMTEXT is a system initialization parameter. GMTEXT specifies whether the default logon message text (Oracle Tuxedo Application Runtime for CICS) or your own message text is to be displayed on the logon screen. The message text is displayed by CSGM transaction when a terminal is logged on to ART for CICS.

GMTEXT must be at most 246 characters long and is truncated if it is longer. (See Specify GMTEXT for an example.)

To enable GMTEXT, it is required to configure CLOPT -s option with your [SYSIDNT] for ARTCNX server. For more information, see ARTCNX Configuration.

GMTRAN X(4) Optional A system initialization parameter which specifies the name of the transaction that is initiated by ATI when terminals are logged on to ART CICS. The GMTRAN format is GMTRAN={CSGM|CESN|transaction-id}, where the default value is CSGM.

Note:

To enable GMTRAN, it's also required to specify LOGONMSG=YES in typeterms.desc; however, if LOGONMSG is specified to NO, the screen will be cleared.
BMS X(60) DDS|NODDS, Optional Specifies whether to enable DDS (Device Dependent Support). The default value is DDS, meaning DDS is enabled.

With DDS, BMS uses the following rules to select a physical map:

  • BMS appends the suffix specified in ALTSUFFIX to map set names if the screen size being used is the same as the alternate screen size. In other word, if a transaction has SCRNSIZE(ALTERNATE) specified in the TYPETERM definition, or if the default screen has the same size as the alternate screen, BMS map selection routines try to load the map set with the suffix specified in ALTSUFFIX.
  • If there is no such map set found, BMS tries to load an unsuffixed map set version.
TYPE X(8) ARTCICS | TMASNA Optional. The default value is ARTCICS.
PLTPI X(2) Optional Name of the PLT suffix. The length of SUFFIX is 1-2 characters.
PLTSD X(2) Optional Name of the PLT suffix. The length of SUFFIX is 1-2 characters.
SRM_IPCKEY 9(6) IPCKEY Optional. SRM_IPCKEY specifies the IPCKEY (the identifier) of the shared memory segment.

Use SRM_IPCKEY only when your ARTSRM server uses shared memory to store runtime information (if ARTSRM uses database, SRM_IPCKEY is ignored). If you do not specify SRM_IPCKEY when using shared memory, ARTSRM uses its Tuxedo group number to generate an IPCKEY.

Within in a single CICS region, SRM_IPCKEY must be the same for every ARTSRM in this region, and all of these ARTSRM servers must run on the same machine.

SRM_LOCATION X(32) MEMORY|DB Specifies the storage media for ARTSRM.
  • Memory (default): uses shared memory to store data
  • DB: uses database to store data
PGAIPGM X(8) INACTIVE|A CTIVE The PGAIPGM system initialization parameter specifies the state of the program autoinstall function at initialization.
  • INACTIVE: The program autoinstall function is disabled.
  • ACTIVE (default): The program autoinstall function is enabled.
CICS_RELEASE X(4) Optional Specifies CICS system code that returns in CICS INQUIRE SYSTEM RELEASE command.

You can specify CICS system code either through environment variable KIX_CICS_RELEASE or through CICS_RELEASE in system configuration file.

If both KIX_CICS_RELEASE and CICS_RELEASE in systems.desc are configured, the value in systems.desc is returned.

If neither KIX_CICS_RELEASE nor CICS_RELEASE in systems.desc is configured, value '0660' (corresponding to CICS 4.1) is returned.

Note:

Section names and keys are case-insensitive; however, values are case-sensitive. The max length of each key is 64 characters and that of each value is 32767 characters.

Parent topic: System Configuration File