1.10.5 PSB Definition - $appname.psb
$appname is the name of a COBOL application program
with type of TP defined in imsapps.desc, $appname.psb
is the PSB definition file corresponding to it. For application
program with type of BATCH, $appname.psb is not used
and the PSB must be provided by the script that calls
DFSRRC00.
The number of [imspcb] sections with
LIST=YES can be (at most) 31. The maximum PCB numbers
including IOPCB is 32.
Note:
The [imspcb] sections with LIST=NO are not counted.
The following table shows an example configuration file with field names mapped from PCB statement for IMS on z/OS.
Table 1-29 Section Name: [imspcb]
| Field | Type | Value | Description | Source in PCB |
|---|---|---|---|---|
NAME
|
X(1..8)
|
blank or transact ion code name
|
If the type is TP, this field represents a Transaction Code, only transaction code is supported for alternate PCB It is mandatory if modify = no, and optional if modify = yes. If the type is DB, this field represents the DB name. This field must be configured for a GSAM PCB, but optional for a DB PCB, please refer to PROCSEQ field for details.
|
NAME
|
TYPE
|
enum
|
TP|GSAM| DB
|
TP means Alternate PCB, GSAM means PCB for GSAM DB DB means PCB for DEDB | TYPE
|
LIST
|
Bool
|
Yes|No
|
Specifies whether the named PCB is included in the PCB list passed to the application program at entry, must together with the LABER= parameter
|
LIST
|
Following fields are only applicable to TYPE=TP, i.e. alternate PCB, will be ignored if configured but TYPE!=TP
|
||||
MODIFY
|
Bool
|
Yes|No
|
Whether this PCB is modifiable, default is no | MODIFY
|
EXPRESS
|
Bool
|
Yes|No
|
Whether it is an express PCB, default is no | EXPRESS
|
LABEL
|
X(8)
|
Yes
|
This parameter is required for DB PCBs while using ODBA, and also required for alternate PCBs if AIBTDLI interface is used to call DL/I. | PCBNAME
|
PROCSEQ
|
X(8)
|
Indexing Database name
|
If this field is configured, it should be filled in the first 8 bytes of DB PCB; otherwise, the value specified by NAME= must be filled in the first 8 bytes of DB PCB. At least one of NAM= and PROCSEQ= must be configured for a DB PCB.
|
PROCSEQ
|
PROCOPT
|
X(4)
|
GSAM: one of G|L|GS|L S DEDB: One or Combination of A|G|I|R| D|P|O|N| T|E|L|GS |LS|H |
This field defines the access permission for the associated database. This field is only valid when TYPE=GSAM|DB, and is ignored if configured but TYPE=TP. GSAM: G|GS - Get Only; L|LS - Get and Append DEDB: TBD DEDB: Tuxedo ART for IMS servers do not check the validity of PROCOPT, which is migrated from IMS on z/OS and only used by DB plug-in
|
|
Following fields are only applicable to TYPE=DB, i.e. GSAM PCB, will be ignored if configured but TP!=DB
|
||||
SB
|
Enum
|
COND|NO
|
Specifies whether this PCB should be buffered. | SB
|
POS
|
Enum
|
SINGLE|MULTIPLE
|
Specifies single or multiple positioning for the logical data structure. | POS
|
KEYLEN
|
int
|
Positive integer
|
Specifies bytes of the longest concatenated key for a hierarchic path of sensitive segments. | KEYLEN
|
MSDB
|
bool
|
YES|NO
|
Specifies the MSDB commit view.
|
VIEW
|
SENSEG
|
X(8)
|
Literal String
|
Specifies the SENSEG name belongs to this pcb, must be unique in current PSB file.
|
|
Section Name: [$SEGSEG ]
|
The section name is defined in imspcb section through SENSEG item.
|
|||
NAME
|
X(8)
|
Literal String
|
Specifies segment name. | SENSEG - NAME
|
PARENT
|
X(8)
|
Literal String|0
|
The name of the segment parent. | SENSEG -PARENT
|
PROCOPT
|
X(4)
|
One or Combination of A|G|I|R| D|P|O|E| L|GS|LS| H |
Indicates the processing options valid for use of this sensitive segment, the SENSEG PROCOPT overrides the PCB PROCOPT
|
SENSEG - PROCOPT
|
SSPTR
|
Struct array
|
One or Combination of interger ,R|U linked with semicolon |
Specifies the subset pointer number and the sensitivity for the pointer. | SENSEG - SSPTR
|
INDICES
|
X(8)
|
Literal String
|
Specifies which secondary indexes contain search fields that are used to qualify SSAs for an indexed segment type. | SENSEG - INDICES
|
SENFLD
|
X(8)
|
Literal String
|
Specifies the SENFLD name belongs to this senseg, must be unique in current PSB file. | SENSEG - INDICES
|
Section Name: [$SENFLD ]
|
X(8)
|
The section name is defined in senseg section through SENFLD item.
|
||
NAME
|
X(8)
|
Literal String
|
Specifies field name. | SENFLD - NAME
|
START
|
Int
|
Positive integer [1-32767 ]
|
Specifies the starting position of this field relative to the beginning of the segment. | SENFLD - START
|
REPLACE
|
bool
|
YES|NO
|
Specifies whether or not this field can be altered on a replace call. | SENFLD - REPLACE
|
Parent topic: Configuration Files