Workload Documentation › DB.4 Workload Documentation Panels › DB.4.4 - Data Set Documentation Panel

DB.4.4 - Data Set Documentation Panel

The DB.4.4 - Data Set Documentation panel lets you define data set level documentation. Data sets whose name is longer than 41 characters cannot use this panel.

To display the panel, enter:

• 4 as the FUNCTION on the DB.4 Menu panel.
• 4.4 as the FUNCTION on the DB Menu panel.
• DB.4.4 as the FUNCTION on any other menu or formatted input panel.
• DB.4.4 or PROSE,DSN as a top line command.

To exit the panel:

• Press PF3 to return to the DB.4 Menu panel except with the TSO/ISPF interface when PF3 has been assigned to another function.
• Move the cursor to the top line of the panel and enter the wanted top line command if yet another function is wanted.

 -----------------------  CA-7 DATA SET DOCUMENTATION  ------------------------
 FUNCTION: xxxxxxxx  (APPEND,CLEAR,DELETE,EDIT,FE,FETCH,LIST,REPL,SAVE,UPD)





 DSN: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx     DSNBR: nnnnnnnn


 DESC: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx  LINK: nnnnnn

 STEP: xxxxxxxx  DDNAME: xxxxxxxx
 REPORT-ID: xxxxxxxxxxxxxxxxxxxx
 FORM: xxxxxxxx  TRAIN: xx  CARRIAGE: xxxx  COPIES: nnn


 ACTIVE SIZE: nnnn


 PROGRAM: SM11  MSG-INDX: nn  -- DB.4.4   --  yy.ddd / hh:mm:ss
 MESSAGE:

This panel contains the following fields:

FUNCTION

Specifies the function to perform. Value must be the name of some other panel or one of the following values:

APPEND

Retrieves documentation data from the database and attaches documentation text to the end of any existing lines in the Active Area (text work area).

CLEAR

Clears panel input data fields and clears the Active Area of the user.

DELETE

Deletes a documentation member from the database.

EDIT

Transfers the user to the EDIT facility and allows text processing.

FE

Combines FETCH and EDIT.

FETCH

Retrieves documentation data from the database and replaces the Active Area of the user with documentation text.

LIST

Lists documentation data only. In batch, a formatted panel is not listed; only a found or not found message is returned.

REPL

Replaces a documentation member in the database.

SAVE

Adds a documentation member to the database.

UPD

Updates formatted panel fields only. UPD does not affect the documentation text.

Batch keyword: Positional parameter

n/a

Contains a constant value of DSN for data set documentation.

Limits: Required for batch only.

Batch keyword: Positional parameter

DSN

Specifies the data set name for which the documentation is being defined.

Limits: 1 to 41 alphanumeric characters and required unless DSNBR is used.

Batch keyword: DSN

Note: The data set name must not exceed 41 characters to permit PP. to be added as part of the data set name in the IDs.

DSNBR

Specifies the data set for which the documentation is being supplied. Must be the data set number that CA WA CA 7 Edition assigned when the data set was first defined.

Limits: 1 to 8 numeric characters and required unless DSN is used.

Batch keyword: DSNBR

DESC

(Optional) Specifies an optional description of the data set.

Limits: 1 to 45 alphanumeric characters

Batch keyword: DESC

LINK

(Optional) Specifies the number of another documentation member to link to the documentation member listed. Linking documentation members together causes them to be listed together as if they were a single member. The LINK member is listed after the requested member when using the LPROS command only.

Limits: 1 to 6 numeric characters

Batch keyword: LINK

Note: You can create an LPROS loop. Do not link linked documentation to itself. The following example shows a loop:

A linked to B
B linked to C
C linked to A

The following fields are informational only:

STEP

(Optional) Specifies the name of a job step in a particular job for which the documentation is being defined.

Limits: 1 to 8 alphanumeric characters

Batch keyword: STEP

DDNAME

(Optional) Specifies a ddname for which the documentation is being defined.

Limits: 1 to 8 alphanumeric characters

Batch keyword: DD

REPORT-ID

(Optional) Provides identification of a printed report.

Limits: 1 to 20 alphanumeric characters

Batch keyword: REPORT

FORM

(Optional) Specifies the output form number.

Limits: 1 to 8 alphanumeric characters

Batch keyword: FORM

TRAIN

(Optional) Specifies the type of printer train required.

Limits: 1 to 2 alphanumeric characters

Batch keyword: TRAIN

CARRIAGE

(Optional) Specifies the type of carriage control required.

Limits: 1 to 4 alphanumeric characters

Batch keyword: CARR

COPIES

(Optional) Specifies the number of original copies required.

Limits: 1 to 3 numeric characters from 0 to 255

Batch keyword: COPIES

ACTIVE SIZE

Identifies a system-generated field that shows the number of lines of text existing in the Active Area for the current terminal session.

More information:

Using the Edit Facility