Professional Documents
Culture Documents
Pocket Guide
DBPOC000251A
IBM Software
30, rue du Château-des-Rentiers
75640 Paris Cedex 13 - France
Internet : http://www.software.ibm.com/ad/vapacbase
48 1
NOTES
Conventions
In the entities choices descriptions, (M) means Update
allowed
2 47
TABLE OF CONTENTS
Management of Users
Parameters The Function Keys ........................................... 4
Function Keys
Number Standard significance
Number Significance
PF1 Recall screen memorized in M1 (equivalent to
operation code R1)
PF4 Help for the screen
PF2 Recall screen memorized in M2 (equivalent to
operation code R2) PF5 Back to general menu
PF5 Return to main menu (equivalent to choice H) PF10 Entity called by cursor positioning
4 45
70 - Existence validation 05 IT ID-ER=0' THE CHOICE FIELD
AN dd-IB n=1'
70dd - Existence validation on 10 BL
dd-file (for each appropriate d.s.) Presentation
73 - Update 05 IT ID-ER=0' 1 - Access an Entity
AN SE-ER(I01)=1'
n Each entity is identified by a 1-character entity type
76 - Store errors & Backout 05 BL
code:
76dd - Backout for dd-file 10 IT FTBn=1
(for each appropriate d.s.) AN GR-ER=1'
* LIBRARY
K KEYWORD
8r - Report logic for report r 05 IT condition
T TEXT
by report structures: on -D (top)
V VOLUME
8rzz - Loads Constant Part 10 BL
U USER MANUAL
8r00 - Loads Variable Part 10 BL
E ELEMENT
8r99 - Physical Write 10 BL
D DATA STRUCTURE
90 - Write files 05 BL S SEGMENT
I INPUT AID
90dd - Write dd-file 10 BL
B BLOCK DATABASE
9099 - ITER-FN. GO TO F05 10 BL
O ON-LINE SCREEN
R REPORT
P PROGRAM
M MODEL ENTITY
F USER ENTITY
Q USER RELATIONSHIP
$ USER ENTITY ITEM
NB: For a detailed description of Generated Batch NB: Available function keys and choice, operation,
Program, see the Batch Systems Development Reference action code fields are detailed in the User Interface
Manual. Guide.
44 5
n Cross-References of an entity are accessed by Batch Program Standard Structure
entering X, optionally followed by the key of the
first line to be displayed:
(This structure will vary, depending on the environment.
Element X-Reference to Program pppppp, starting with
Based on the specifications entered, all or none of these
Procedural Code ff sf lll:
functions may be generated.)
E ...... XP {pppppp P ff sf lll}
01 - Initializations 05 BL
n Assigned Text is accessed by entering AT:
01dd - Open Files or Initialize 10 BL
On-Line Screen Assigned Text O ...... AT
Table (Data Structure dd)
(for each d.s. to open)
n General Documentation is accessed by entering G:
Input Aid General Documentation I ...... G
05 - Read sequential files with no control break 05 BL
05dd - Read dd-file 10 BL
Remark: Once an entity has been selected, the combination
(for each appropriate d.s.)
entity type/entity code can be replaced with a -.
10 - Read sequential files with control break 05 BL
10dd - Read dd-file 10 BL
2 - Lists of entities (for each appropriate d.s.)
6 43
Tables used for Reports Library
CAT-TAB Category table: stores all categories to be Definition (U)
printed in this iteration. * ...
ST-TA Table storing the structure number, constant General Documentation (U)
part number, and page/line skip for the * ... G ...
category to be printed.
Cross-References to User Relationship
r-LAB Table containing constants for report r. * ... XQ ......^...
5-dd00- Line Counter. Initially set equal to the maxi- List of Keywords by code
rLC mum number of lines for report r to allow for LCK .............
a new heading situation. Automatically
handled by VisualAge Pacbase.
42 7
Element SE-ERR Stores the presence status of each transac-
tion file record type.
Generated if the program contains a transac-
Definition (U)
tion file (to be validated or not).
E ......
Each record type is provided with a status
field within this table. This field is named
General Documentation (U)
SE-ER(I01).
E ...... G ...
The values vary at different points in the
processing cycle:
Assigned Text
0 record absent
E ...... AT ......
1 record present
2 invalid absence of record
Cross-References
3 invalid presence of record
E ...... X
7 duplicate record
8 invalid creation
toText
9 invalid modification or deletion
E ...... XT ......
TR-ER The last field in the table is named TR-ER
to Model Entity
and is used for storing errors detected.
E ...... XM ......
1 no error detected
4 an error is detected
to User Relationships
E ...... XQ ......
SE-ERE Stores the presence status of the record being
processed.
to Volume
E ...... XV ......
GR-ER Stores information concerning errors
detected on a group of transactions which
to Segments
update a record, of at least one principal data
E ...... XS ....
structure.
to Reports
UT-ERUT Stores the users errors.
E ...... XR ...
E ...... XR ... CE
to Database Block
E ...... XB ......
E ...... XB ...... DH ...
E ...... XB ...... DC ...
E ...... XB ...... DR ...
to On-Line Screens
E ...... XO ......
E ...... XO ...... CP ......
E ...... XO ...... W -- ...
E ...... XO ...... B ..--...
E ...... XO ...... P .. -- ...
8 41
Table Indexes to Programs
E ...... XP ......
E ...... XP ...... CP ......
IddssM Maximum number of table entries, specifie by
E ...... XP ...... W -- ...
the user, for a table defined by Data Structure
E ...... XP ...... B ..--...
dd, segment ss.
E ...... XP ...... P .. -- ...
E ...... XP ...... 8 ......
IddssL Number of entries actually loaded from
E ...... XP ...... 9 ......
segment ss in data structure dd. This number
E ...... XP ...... FC -- ...
cannot exceed the maximum specified above.
Description (U)
IddssR Varying from 1 to IddssL, used for all look-ups
E ...... D ...
on the table loaded from data structure dd,
segment ss. Once the table is loaded, this in-
List of Undefined Elements in Dictionary
dex is initialized to zero if there is no overflow,
by code LFE ......
or to the number of records read if an overflow
has occurred.
List of Elements
by code LCE ......
by name LNE ..............
Validation Processing (Work areas for update (U) LUE ......
and variables) (C2 : 3 formats indicated)
by Label LALE .............
by COBOL name LACE .................
DE-ERR Stores the presence status of each data ele-
by Relational name LARE ..................
ment ofthe transaction being processed.
Each elementary data element (eeeeee), other
than FILLER, ENPR, GRPR, ERUT and their sub- Text
elements, is provided with a status field within
the table. This field is named ER-ss-eeeeee Definition (U)
(ss = SEGMENT CODE). T ......
The values vary at different points in the
processing cycle: General Documentation (U)
0 data element absent T ...... G ...
1 data element present
2 invalid absence of data element Assigned Text
3 invalid presence of data element T ...... AT ......
4 erroneous class
5 invalid content Cross-References
T ...... X
ID-ER The last field in the table is ID-ER and is used
for storing the record identification status: Cross-References to User Manual
0 record type and action code are valid T ...... XU ..
values
5 error detected on record type Cross-References to Volume
6 error detected on action code T ...... XV ......
DEL-ER Stores the presence status of the data element Cross-References to Documentation
being processed. T ...... XG ...
Generated if the program contains a transac-
tion file (to be validated or not). Cross-References to Text
T ...... XT ......
ER-PRR Used only to carry out transfers between DE-
ERR and a data structure (USAGE OF D.S. = Cross-References to User Relationships
M, N or E) with a reduced error array. T ...... XQ ......
40 9
Description of Section (U) BATCH PROGRAM GENERATION
T ...... D .. ---
38 11
Data Structure
10 FDDSS-SELC
Selection processing
Definition (U)
D ..
15 FDDSS-SELC-CATX
X Category processing (X = 'A': before
General Documentation (U)
repetitive, 'R': repetitive, 'Z': after repetitive)
D .. G ...
20 FDDSS-SELC-CATX-SRVA
Assigned Text
Selection service processing
D .. AT ......
25 FDDSS-SELC-CATX-SRVA-INIT
Cross-References
Initialization
D .. X
25 FDDSS-SELC-CATX-SRVA-SELC
to User-Defined Relationships
Logical selection processing
D .. XQ ......
25 FDDSS-SELC-CATX-SRVA-TRAN
to Volumes
Loading after selection
D .. XV ......
25 FDDSS-SELC-CATX-SRVA-DONE
to Programs
End of service processing
D .. XP ......
D .. XP ...... W -- ...
10 FDDSS-USER
User processing
to Screens
D .. XO ......
10 FDDSS-ERRV
D .. XO ...... W -- ...
DDSS logical view error processing
Data Structure List
10 FDDSS-ENDV
of segments D .. LS ..
End of DDSS logical view processing
of reports D .. LR .
05 FSERVER-END
List of Data Structures
End of server processing
by code LCD
10 FDDSS-TRDT
by type LTD .
Transfer of the logical view data to the
LTD . D ..
Segment data in physical access
by external name LPD ......
15 FDDSS-TRDT-CATX
X Category processing (X = 'A', 'R' or 'Z')
10 FDDSS-CHKD
Logiciel view data control
10 FDDSS-CHKD-CATX
X Category processing (X = 'A', 'R' or 'Z')
10 FDDSS-TRVW
Transfer of Segment data to the logical view
data
15 FDDSS-TRVW-CATX
X Category processing (X = 'A', 'R' or 'Z')
NB: For a detailed description of Data Structure and
Segment entities, see the Specifications Dictionary 10 FSSNN-CHCK
Reference Manual. Logical check access processing of SSNN
Segment
12 37
Business Component Segment
Structure Definition (U)
S ....
05 FSERVER
Beginning of server processing
General Documentation (U)
S .... G ...
10 FSERVER-STRVIEW
Structure validation and length of the
Assigned Text
communication area buffers
S .... AT ......
05 FSQL
List within Segments
SQL declaration
of Parent Segments S .... LSP ....
of Child Segments S .... LSC ....
10 FSQL-WHENEVER
Clause Whenever
Cross-References
S .... X
10 FSQL-CURSR-SEET
Declare Cursor
to Segments
S .... XS ....
05 FDDSS
Processing of the DDSS logical view
to User-Defined Relationships
S .... XQ ......
10 FDDSS-BEGV
Initialization of the logical view processing
to Volumes
S .... XV ......
10 FDDSS-CHUP
Check/update processing
to Database Blocks
S .... XB ......
15 FDDSS-CHUP-CATX
X Category processing (X = 'A': before
to Programs
repetitive, 'R': repetitive, 'Z': after repetitive)
S .... XP ......
S .... XP ...... W -- ...
20 FDDSS-CHUP-CATX-SRVO
O Service processing (O = 'E', 'L', 'M', 'T' or 'X') to Screens
S .... XO ......
25 FDDSS-CHUP-CATX-SRVO-INIT
S .... XO ...... W -- ...
Initialization
Sub-schemas and Sub-systems (U)
25 FDDSS-CHUP-CATX-SRVO-CHCK
S .... SS .-
Logical check processing
Integrity Constraints on Segment
25 FDDSS-CHUP-CATX-SRVO-TRAN
S .... CN ......
Loading before update
Call of Elements (U)
25 FDDSS-CHUP-CATX-SRVO-UPDT
(C2 : internal format)
Logical update processing
(C3 : output format)
S .... CE ...
25 FDDSS-CHUP-CATX-SRVO-DONE
Documentation (U)
End of service processing
S .... CE ... G ...
10 FDDSS-LOCK
View of statistical information
Lock
Level, Address and Length S .... LAL
Data Element Details S .... DED
10 FDDSS-UNLK
Statistics S .... STA
Unlock Activity S .... ACT
36 13
DB2 View Description (U) S .... DBE ... Display 03 IT OCF = '1'
14 35
C/S Screen Structure Program
01 - Initializations 05 BL Definition (U) P ......
NB: For a detailed description of Generated On-Line NB: For a detailed description of Program entity, see the
Program, see the OLSD Reference Manual for the Structured Code Reference Manual.
concerned On-line monitor.
34 15
On-Line Screen OPER Operation code
'A' Display
'M' Update
Definition (U)
'S' Screen continuation
O ......
'E' End
'P' Same Screen
General Documentation (U)
'O' Call of another Screen
O ...... G ...
CATM Transaction code
Assigned Text
'C' Creation
O ...... AT ......
'M' Modification
'A' Deletion
Cross-References
'X' Implicit update
O ...... X
CATX Code of the category being executed
to Screens
'0' Beginning of reception or display
O ...... XO ......
'' Screen-top
'R' Repetitive
to User-Defined Relationships
'Z' Screen-bottom
O ...... XQ ......
ICATR Indicator for current category being processed
to Volumes
(Repetitive category only)
O ...... XV ......
FT End of repetitive category indicator
to Segments
'0' Lines to display
O ...... XS ....
'1' No more lines to display
Call of Elements (U)(C2)(C3)
ddss-CF Segment configuration indicator
O ...... CE ...
'0' Segment I/O area does not contain a re-
cord
Call of Segments (U)
'1' Segment I/O area contains a record.
O ...... CS - ....
IK Error indicator for Segment access or server
Call of P.M.S. (U)
call
O ...... CP ......
'0' No error
'1' Error
Beginning Insertions (U)
O ...... B .. -- ... (C2 : with source)
Error variables
Work Areas (U)
O ...... W -- ... (C2 : with source) CAT-ER Ongoing error indicator for current
category
'' No error
Procedural Code (U) 'E' Error
O ...... P .. -- ... (C2 : with source)
SCR-ER Screen error indicator
'1' No error
Layout (U) '4' Error
O ...... L .. C ... (C for column)
ER-scrn-delcod Data Element error indicator
0 Absent Data Element
Mapping (U) 1 Present Data Element
O ...... M .. C ... ( C for column) 2 Invalid absence of Data Element
3 Invalid presence of Data Element
Dialogue Complement (U) 4 Erroneous class
5 Invalid content
O ...... O scrn : last four characters of the screen code
delcod : Data Element code
Dialogue Simulation (C1, C3, C4 or C5)
O ...... SIM .. DEL-ER Memorization of the Data Element
Presence or Status at a given time
16 33
ON-LINE GENERATION Address of Elements
O ...... ADR .. C ...
32 17
Database Block Structured code condition types
Definition (U)
B ......
Assigned Text
B ...... AT ......
Cross-References
B ...... X
to Volumes
B ...... XV ......
to User Relationship
B ...... XQ ......
to Blocks in PSBS
B ...... XB ......
to Screens
B ...... XO ......
B ...... XO ...... CS ....
B ...... XO ...... W ..
to Programs
B ...... XP ......
B ...... XP ...... W ..
BL Block
Description (Hierarchical) (U) IT If then
B ...... DH ... EL Else (only after an IT)
Documentation (U) CO Case of (followed by ITs)
B ...... DH ... G ... DW Do white
DU Do until
Description (Codasyl/DB2) (U) DO Do (Generates Subscript: JffssR)
B ...... DC ... OR Or
Documentation (U) AN And
B ...... DC ... G ...
Relative positioning (On-line only)
Description (Relational/SQL) (U)
B ...... DR ...
*A To insert the sub-function before the automatic
Documentation (U)
sub-function (F20, F25, F35 andF65)
B ...... DR ... G ...
*P To insert the sub-function after the automatic sub-
Building of Relational/SQL Key (U)
function (F20, F25, F30, F35, F60 and F65)
B ...... DR ... K
*R To replace an automatic sub-function (F20, F25,
F35, F60 and F80)
Description (Turbo.Image)(U)
B ...... DT ...
Documentation (U) Specific Business Component
B ...... DT ... G ...
*C Insert or replace code in the server or for a logical
Generation of SQL commands view. It must be defined on a level 05
B ...... GEN *B To insert in the elementary processing called by
PERFORM.
18 31
XRN Read next occurrence of segment Interactive SQL
XRU Read for update of segment B ...... SQL
XW Write segment
XRW Rewrite segment List of Blocks
XD Delete segment by code LCB ......
XUN Unlock segment (VSAM) by type LTB..------
Yaa Create paragraph labels (F80-ddss-aa) by external name LEB -- .......
Xaa With Yaa, Perform of paragraph
F80-ddss-aa List of Areas by code LCA ......
ERU User error (specified at dialogue level) List of Codasyl Sets by code LCC ......
ERR User field error
Codasyl Activity on a Set C ...... ACT
NB: For a detailed description of Structures Types, Operator NB: For a detailed description of Database Block entity,
and of Specific operators lists (On-line monitors or see the Database Description Reference Manual of the
Database), see the Stuctured Code Reference Manual. database concerned. For Model entity, see the
Specifications Dictionary Reference Manual.
30 19
User Entity (Extensibility) COBOL II Operators
Definition (U) CON Continue (no operand)
F ...... EVA Evaluate
EVT Evaluate True
General Documentation (U) EVF Evaluate False
F ...... G ... EEV END-Evaluate (no operand)
EIF END-IF (no operand)
Assigned Text EPE END-PERFORM (no operand)
F ...... AT ...... ESE END-SEARCH (no operand)
INI INITIALIZE
Cross-references F ...... X SEA SEARCH
GOB GO BACK
to Volumes F ...... XV ......
20 29
STRUCTURED CODE User Entity Occurrence
General Operators Definition (U)
$ -- ......
N Title, must be line 000
General Documentation (U)
* Comment
$ -- ...... G ...
M Move
MA Move all
Assigned Text
P Perform
$ -- ...... AT ......
C Compute
A Add
Cross-References
S Subtract
$ -- ...... X
MP Multiply
DV Divide into
to Volumes
MES Display message
$ -- ...... XV ......
ACC Accept
STR String
to User-Defined Relationships
UNS Unstring
$ -- ...... XQ ......
CAL Call
GT Go to end of current sub-function with level
Description (U)
number nn
$ -- ...... D - ...
GFT Go to end of iteration
GDI Go to beginning of iteration
List of User Entity Occurrences by code
GB Go to beginning of current loop with level
LC$ -- ......
number nn
EXA Examine
EXC Used to access the VisualAge Pacbase
Repository through CICS
INS Inspect
COB COBOL B margin
COA COBOL A margin
SUP Suppress
SCH Search (not COBOL search)
SCB Search (on sorted table)
ADT Call system date (6 characters)
ADC System date with century (8 characters)
AD Date format : Century positioned from
CENTUR field.
AD0 Date format : Century positioned from
DAT-CTY
AD1 Date format : Century set to 19 if year
< value in DAT-CTYT field.
AD2 Date format : Century set to 20 if year
< value in DAT-CTYT field.
ADI Date inversion (6 characters)
ADE Date with slash (8 characters)
TIM TIME HHMMSS format
TIF HHMMSS to HH:MM:SS
28 21
Special Choices USER ENTITY
R nn Lines renumbering with nn interval (default=20). NB: All the Generation and Print Commands are grouped
in the Bath Procedures Manual - User's Guide. They are
detailed, for each entity, in the Reference Manual of the
concerned Module.
22 27
CLIENT/SERVER ENTITY OPERATION FIELD
DGC Description of a C/S Screen.
C1 Selected library and higher level
DGS Description of a Business Component
libraries
GGC Generate a C/S Screen
GGS Generate a Business Component
U1 Selected library only
GVC Generate a Proxy Logical View
(from Server Component)
Z1 Selected library and lower level libraries
ERROR MESSAGES
I1 Selected library and lower and higher
level libraries
LEC List of error messages for a Client
Component/Screen
>1 Higher level libraries
LED List of error messages for a Data Structure/
Segment
<1 Lower level libraries
LEO List of all error messages for a On-line
Dialogue/Screen
A1 Identical to C1 with display of
GE6 Generation of error messages for a (R6) file
duplicates
GED Generation of error messages for a Data
Structure/Segment
Mn Stores or memorizes the screen upon
GEO Generation of error messages for a Dialog/
which the request is executed (n=1-9)
Screen
GIP Generation for the VisualAge Pacbase-
Rn Recalls the screen that was stored by
GIP Interface
the Mn operation (n=1-9)
GEC Generation of error messages for a C/S
Dialogue/Component
FT Final Transaction
C1 Error messages for the Dialog and for each
Screen
C2 C1 plus documentary help messages
C3 Error messages for the Dialog only
C4 PAW revamping (GEO) ACTION CODE FIELD
DATABASE BLOCKS Blank lmplicit Update (create or modify)
C Create
DTB Database Blocks description by Type M Modify
GCB Generation of source: Database Blocks D Delete
GSQ Generation of DDL for Relational/SQL block B Block (multiple) deletion
LCB List of Database Blocks by Code L End delimiter of multiple deletion
LEB List of Database Blocks by External name E or -Inhibits implicit update on the line
LKB List of Database Blocks related by Keywords ? Help documentation
LTB List of Database Blocks by Type S Split line of text where cursor is positioned
LES List of SQL objects by External name T Line transfer
LTS List of SQL objects by Code G Group line transfer
L End delimiter of group line transfer
MODEL ENTITIES I nnn Insert nnn lines here (nnn is entered in the Line
number field).
DCM Description of the Model Entity R nnn Repeat nnn times, beginning with the line number
DCMC Functional Integrity Constraints Description where the R action code is entered (nnn is entered
DCMO Model Objects description in the next field).
DCMR Model Relationships description J nnn On any line other than an 1, R or S line, gives the
LCMC List of Model F.I.C. by Code step nnn by which to increment line numbers
LCMO List of Model Objects by Code (optional, defaults to calculated line number).
LCMP List of Model Properties by Code X Explicit update (creation/modification)
LCMR List of Model Relationships with F.I.C.s.
LKM List of Model entities related by Keywords
26 23
GENERATION AND PRINT DATA STRUCTURES
24 25