gtpp1m0nProgram Development Support Reference

Standard Data Message File Update (SDMU) Program

The standard data message file update (SDMU) program enables you to:

The user-defined control records identify the SDMU function desired. The STC utility will transfer control to the appropriate SDMU program upon reading the input. You can request a dump of an SDMF record, all SDMF records, or a listing of the SDMF directory.

SDMF Generation

When a new SDMF tape is generated, the old SDMF tape must be mounted. Only the records generated during the CREAT run will be written on the new SDMF tape; no old SDMF tape records will be written on the new tape. Up to 5,000 records can be created during one CREAT run.

Input for SDMF Generation

SDMU CREAT

Notifies SDMU that a new SDMF tape will be generated.

Table 14. SDMU CREAT Format

Position Content Description
1 Blank Not Applicable
2-5 SDMU Record identification.
6-9 Blank Not Applicable
10-14 CREAT SDMU function.
15 Blank Not Applicable
16-80 Comments Not Applicable

SDMU ENTER

Indicates a new record will be written on the SDMF tape. The record identification begins at position 16 and must be 12 characters. The first 5 characters are the record name (for example, WA0AA for the AAA), and the last 7 characters are the sequence number.

After the record identification, the first 17 characters following the comma will be considered comments, and are placed in the header of each record created. By convention, the first 12 characters are the programmer name and the next 5 characters are the Julian date (YYDDD). If more than one record is created with the same SDMU ENTER, the sequence number of each record is automatically incremented by one.

Table 15. SDMU ENTER Format

Position Content Description
1 Blank Not Applicable
2-5 SDMU Record identification.
6-9 Blank Not Applicable
10-14 ENTER SDMU function.
15 Blank Not Applicable
16-27 Record ID Not Applicable
28 Comma Not Applicable
29-80 Comments Not Applicable

Data

Data generation detail records are used to create new data records or messages. See DATA and MSG Records for more information about these records.

SDMU END

There must be an SDMU END record to identify the end of input for the SDMU activity (creation, generation, or maintenance).

Table 16. SDMU END Format

Position Content Description
1 Blank Not Applicable
2-5 SDMU Record identification.
6-9 Blank Not Applicable
10-12 END SDMU function.
13-80 Blank Not Applicable

Sample SDMU CREAT Run

In Figure 25, the SDMU CREAT run creates 4 new records and writes them on the SDMF tape. The new records will have the following record IDs:

The record ID sequence number are incremented automatically so that no 2 records in the library have the same ID.

Figure 25. Sample SDMU CREAT Run


|...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
 SDMU    CREAT
 SDMU    ENTER WA0AA0000005,JOHN JONES  66073
WA0AA    GSTAR 4.
WA0BID   REP   WA-1-4.
WACIT    ENT   ALB,NYC,CHI,CIN.
WA0TY2   SUB   X'40'-2-2-4.
         GEND
 SDMU    END

SDMF Maintenance

You may want to change an SDMF tape after it has been created. Records can be added, deleted, or altered in an SDMU UPDAT run. The old SDMF tape must be mounted. After all the input records are read, for example, after the SDMU END is read, SDMU will load all the new records on the SDMF tape together with all the records from the old SDMF tape that were not affected by the UPDAT run.

The number of new records added during an UPDAT run should not result in the 5,000 maximum being exceeded; any records exceeding the maximum will be ignored.

Input for SDMF Maintenance

SDMU UPDAT

Indicates to SDMU that an UPDAT or maintenance run will follow.

Table 17. SDMU UPDAT Format

Position Content Description
1 Blank Not Applicable
2-5 SDMU Record identification.
6-9 Blank Not Applicable
10-14 UPDAT SDMU function.
15 Blank Not Applicable
16-80 Comments Not Applicable

SDMU ENTER

See SDMU ENTER for more information.

SDMU ALTER

Indicates a record from the old SDMF tape will be replaced with an altered record.

Table 18. SDMU ALTER Format

Position Content Description
1 Blank Not Applicable
2-5 SDMU Record identification.
6-9 Blank Not Applicable
10-14 ALTER SDMU function
15 Blank Not Applicable
16-80 Record ID Comments Not Applicable

SDMU DELET

Indicates a record from the old SDMF tape will be deleted.

Table 19. SDMU DELET Format

Position Content Description
1 Blank Not Applicable
2-5 SDMU Record identification.
6-9 Blank Not Applicable
10-14 DELET SDMU function.
15 Blank Not Applicable
16-27 Record ID Not Applicable

Data

See Data Generation Detail Records for more information.

SDMU END

See SDMU END for more information.

Sample SDMU UPDAT Run

In Figure 26, this SDMU UPDAT runs adds records PD1PD0000007, PD1PD0000008, PD1PD0000009, and GROUP00000012 to the new SDMF tape. WA0AA0000002 will not appear on the new tape. WA0AA0000005 will be the same on the new SDMF tape as it was on the old with the exception that field WA0AGC will now contain AGAA. All other records on the old SDMF unaffected by this update will appear on the new SDMF tape as they existed on the old tape.

Note:
On the BSTA06 card, you must code the SYSEQ symbol for the FACE type record (#PNDRI in this example). Do not code the decimal equate value.

Figure 26. Sample SDMU UPDAT Run


|...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
 SDMU    UPDAT
 SDMU    ENTER PD1PD0000007,SMITH
PD1PD    GSTAR 3.
PD1BID   REP   PD-1-3.
PD1CHK   ENT   X'04',X'07',X'11'.
BSTA06   ADD   (#PNDRI)30-1-1-3.
         GEND
 SDMU    ALTER WA0AA0000005.
WA0AA    GSTAR WA0AA00000005,1.
WA0AGC   ENT   AGAA.
         GEND
 SDMU    DELET WA0AA0000002.
 SDMU    ENTER GROUP0000012.
36       GSTAR 1.
0        ENT   PG1PG0000001.
12       ENT   PG1PG0000002.
24       ENT   PG1PG0000003.
         GEND
 SDMU    END

SDMF Regeneration

It may be desirable to change the SDMF tape if there have been changes in DRIL record formats. During an SDMU REGEN run, the old SDMF tape must be loaded. The REGEN run is similar to the UPDAT run: records on the old SDMF tape can be altered and deleted. However, all the records indicated by the input records will be regenerated before they are written on the new SDMF tape. The number of new records added during a REGEN run should not result in the 5,000 maximum being exceeded; any records exceeding the maximum will be ignored.

Input for SDMF Regeneration

SDMU REGEN

Indicates the SDMF tape is going to be regenerated.

Table 20. SDMU REGEN Format

Position Content Description
1 Blank Not Applicable
2-5 SDMU Record identification.
6-9 Blank Not Applicable
10-14 REGEN SDMU function.
15-80 Blank Not Applicable

SDMU ENTER

See SDMU ENTER for more information.

SDMU ALTER

See SDMU ALTER for more information.

SDMU DELET

See SDMU DELET for more information.

Data

See Data Generation Detail Records for more information.

SDMU END

See SDMU END for more information.

Sample SDMU REGEN Run

Figure 27 shows a sample SDMU REGEN run.

Figure 27. Sample SDMU REGEN Run


|...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
 SDMU    REGEN
 SDMU    ENTER PD1PD0000012
PD1PD    GSTAR CREATE,2.
PD1BID   REP   PD-1-2.
         GEND
 SDMU    ALTER NP0CP0000026
NP0CP    GSTAR NP0CP0000026,1.
NP0HTL   ENT   X'02'.
         GEND
 SDMU    END

In this SDMU REGEN run, if PD1PD0000012 and PD1PD0000013 were already on the old SDMF tape, these 2 records will be regenerated with PD placed in the PD1BID field of each record before they are written to the new SDMF tape. The rest of each record will contain zeroes. Record NP0CP0000026 will be called from the old SDMF tape and a X'02' will be placed in the NP0HTL field before it is written to the new SDMF tape. All other records on the old SDMF tape will be written as they are onto the new SDMF tape.

SDMF Dump Requests

You can request a listing of all records on the old SDMF tape, a specific record, or the directory of all records on the old SDMF tape.

SDMU DUMPD

Dumps a listing of all the records on the old SDMF tape.

Table 21. SDMU DUMPD Format

Position Content Description
1 Blank Not Applicable
2-5 SDMU Record identification.
6-9 Blank Not Applicable
10-14 DUMPD SDMU function.
15-80 Blank Not Applicable

SDMU DUMPR

Dumps the record with the ID specified in position 16-27.

Table 22. SDMU DUMPR

Position Content Description
1 Blank Not Applicable
2-5 SDMU Record identification.
6-9 Blank Not Applicable
10-14 DUMPR SDMU function.
15 Blank Not Applicable
16-27 Record ID Not Applicable
28-80 Blank Not Applicable

SDMU DUMPT

Dumps all records from the old SDMF tape. The first part of the STC prefix is printed, followed by the record itself.

Table 23. SDMU DUMPT

Position Content Description
1 Blank Not Applicable
2-5 SDMU Record identification.
6-9 Blank Not Applicable
10-14 DUMPT SDMU function.
15-80 Blank Not Applicable