GSAM PCB statement

TYPE=GSAM

Is a required keyword parameter for all GSAM database PCBs that will be allocated and processed in the dependent region.

DBDNAME= or NAME=

Is a required keyword parameter for the name that specifies the GSAM DBD to be used as the primary source of data set description. SENSEG statements must not follow this PCB statement.

PROCOPT=

Is a required parameter for the processing options on the data set declared in this PCB that can be used in an associated application program. Use the following characters to specify the parameter.

G

Get function.

L

Load function.

S

Large-scale sequential activity. Use GSAM multiple-buffering option (BUFFIO).

The GSAM PCB statement must follow the PCB statements with TYPE=TP or DB if any exist in the PSB generation. The rule is:

TP PCBs

First

DB PCBs

Second

GSAM PCBs

Last

PCBNAME=

Specifies the name of the PCB. The PCB name must be an alphanumeric, 8-byte character string that follows standard naming conventions. The PCB name must be unique within the PSB.

Exception: Do not specify this parameter if the PCB statement includes label.

label

Specifies an 1- to 8-character alphanumeric label that is valid for an assembler language statement. The labels for the PCB statements within a PSB must be unique.

Exception: Do not specify this parameter if PCBNAME= is used.

EXTERNALNAME=

An optional alias for the PCB label or the PCBNAME= parameter. Java™ application programs use the external name to refer to the PCB.

Specify an external name as a 1- to 128-character uppercase alphanumeric string. An external name can include underscore characters.

The external name must be unique within a PSB.

When EXTERNALNAME is not specified, the default external name is either the PCB label or the PCBNAME, whichever has been specified.

If no PCB label or PCBNAME is specified, EXTERNALNAME defaults to blanks.

Restriction: External names cannot be reserved SQL keywords or begin with DFS.

If the EXTERNALNAME parameter is not specified and a reserved SQL keyword is specified in the NAME parameter, EXTERNALNAME accepts the NAME value as the default external name after appending _SCH to the NAME value.

LIST=

Specifies whether the named PCB is included in the PCB list passed to the application program at entry. Specify YES to include a named PCB in the PCB list. Specify NO to exclude a named PCB from the PCB list. YES is the default.

To exclude a PCB from the PCB list, you must assign the PCB a name with the PCBNAME= parameter. You can specify LIST=NO if an application program does not need a PCB's address.

REMARKS=

Optional user comments. A 1-character to 256-character field.

If your comments contain special characters, such as commas or blank spaces, enclose the full comment string in single quotation marks.

The value specified on the REMARKS keyword cannot contain the following characters:

• Single quotation marks, except when they are used to enclose the full comment string. If a single quotation mark is entered before the end of the full comment string, the remainder of the comment string is truncated. The following examples show correct and incorrect usages of single quotation marks on the REMARKS keyword:

  CORRECT

  REMARKS='These remarks apply to the XYZ application'

  INCORRECT

  REMARKS='These remarks apply to the 'XYZ' application'

• Double quotation marks.
• Less than (< ) symbols.
• Greater than ( >) symbols.
• Ampersands (&).