Previous Page Contents Page Next Page

4.4 Text File Format

The 5250 style files are ASCII text files, with information stored in readable text format. This allows you to check or modify style files using a standard text editor.

Each style file consists of a header record and a series of data records, each of which contains global information or information about individual sessions. The records that can be included are discussed in more detail in 5250 Style File Records.

Each record is defined in the following format:

[record_name]
parameter_name    =      value
parameter_name    =      value
parameter_name    =      value
      .
      .
      .
parameter_name    =      value

The record_name must be enclosed in square brackets. It is followed by a series of parameter entries, each on a separate line. A backslash character ( \ ) at the end of a line indicates that the entry continues on the next line.

All the parameters associated with a particular record must be listed after the record_name for that record, and before the record_name for the next record in the file. However, the order of individual parameters within a record is not important (except where this is indicated in the record descriptions later in this chapter). The emulation program has a set of default settings for all the parameters, so you only need to specify the parameters you wish to change from the default setting.

A tag parameter is a name that is used to identify and reference data that will be shared by multiple records (so that the value does not need to be duplicated each time). Other records can share the information in that record by using the tag.

Note

4.4.1 Parameter Types

Each parameter in a record is of a defined type-character string, defined constant, or number. For example, in the [define_session_details] record, session_name is a character string and initial_session_state is a defined constant. In the record descriptions later in this chapter, the information given for each individual parameter includes its type.

The following list describes how to specify a parameter of each type, and provides information about valid entries for each type.

Character String

A character string (contained in double quotes), for example 5250 color set. When the string must consist of characters from a particular character set (such as alphanumeric, A-string, or Solaris file name characters), this is noted in the parameter description. Otherwise, you can use any character that is displayable in your computer's local character set. Character strings are case sensitive.

Defined Constant

One of a set of defined values, specified as an ASCII character string without quotation marks, for example CONNECTED . In some cases, a defined constant parameter may be set to a combination of two or more of the defined values, as indicated in the parameter description; where this is not indicated, only one value can be used.

Defined constants are used for parameters where there is a fixed set of valid values, such as DISABLED/ DISCONNECTED/CONNECTED; the individual parameter description lists the defined values for each parameter. Defined constants are not case sensitive (with the exception of most key definitions); you can use either uppercase or lowercase.

Number

A number that specifies the value of a field. Each parameter description will specify the units of this number.

4.4.2 Default Parameter Values

The emulation program provides default values for many of the parameters in the style file records. This means that you do not need to specify every parameter in a record for a standard setup. (However, you may prefer to specify parameters explicitly, to make it easier to check the values that are being used.) These default values are listed in the record description for each record type. For more information about the default settings that the 5250 emulation program uses, see Default Mappings.

Previous Page Contents Page Top of Page Next page