gtpp1m0n | Program Development Support Reference |
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.
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.
Notifies SDMU that a new SDMF tape will be generated.
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 |
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.
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 generation detail records are used to create new data records or messages. See DATA and MSG Records for more information about these records.
There must be an SDMU END record to identify the end of input for the SDMU
activity (creation, generation, or maintenance).
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 |
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 |
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.
Indicates to SDMU that an UPDAT or maintenance run will follow.
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 |
See SDMU ENTER for more information.
Indicates a record from the old SDMF tape will be replaced with an altered
record.
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 |
Indicates a record from the old SDMF tape will be deleted.
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 |
See Data Generation Detail Records for more information.
See SDMU END for more information.
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.
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 |
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.
Indicates the SDMF tape is going to be regenerated.
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 |
See SDMU ENTER for more information.
See SDMU ALTER for more information.
See SDMU DELET for more information.
See Data Generation Detail Records for more information.
See SDMU END for more information.
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.
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.
Dumps a listing of all the records on the old SDMF tape.
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 |
Dumps the record with the ID specified in position 16-27.
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 |
Dumps all records from the old SDMF tape. The first part of the STC
prefix is printed, followed by the record itself.
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 |