Table 4 Masking Formats
Format |
Description |
---|---|
ABC* |
The report name must begin with ABC (that is, prefix). |
*D |
The report name must end with D (that is, suffix). |
ABC*D |
The report name must begin with prefix ABC and end with suffix D. Any characters may be present between the prefix and the suffix. |
* |
All report names are selected. |
A?B1 |
The report name must begin with prefix A and end with suffix B1. Any one character may be present between the prefix and the suffix. |
Following the +++repname line, one or more structured field records may follow.
Any number of +++repname lines can be present in one APAPARM member.
For example, consider the following report decollating mission parameters:
JOBNAME=xxxxxxxx
... DO NAME=report-name1
... DO NAME=report-name2
The member xxxxxxxx in the APAPARM library can contain the following:
+++report-name1
printing characteristics-1
printing characteristics-2
+++report-name2
printing characteristics-1
Not every report requires special processing using the APAPARM option. The APAPARM library must only contain members for jobs that require in-line (in-stream) structured fields, and not for all jobs.
A sample member APAPARMS can be found in the APAPARM library.
When Control-D prints the reports named report-name1 and report-name2, the structured field or fields specified on the lines following the +++ lines are automatically added at the beginning of each report.
The structured field records, following the +++repname line, are in Hexadecimal (Hex) format. (If it is a library with RECFM set to F, then it must be preceded with the RDW, length in bytes.) Here is the structure of the Hex format:
Table 5 Hex Format of the AFP Structure Field
4 BYTES |
1 BYTE |
2 BYTES |
3 BYTES |
1 BYTE |
2 BYTES |
|
|
---|---|---|---|---|---|---|---|
X’00400000 |
X’5A |
length |
SF identifier |
flag |
sequence number |
data |
padding |
(ONLY FOR A LIBRARY WITH RECFM SET TO F)
The APAPARM option provides a simpler method of specifying some of the structured fields, in regular character format. Control-D automatically translates the character format to Hex format at time of printing. The following two special commands can also appear between the AFP structured field records:
IMM=xxxxxxxx (up to eight characters)
IDM=yyyyyyyy (up to eight characters)
xxxxxxxx represents the name of the specific Copy Group in the current FORMDEF and yyyyyyyy represents the Page Format in the current PAGEDEF.
Note: When using this method, there is no need to specify the IMM and/or the IDM commands in Hex format.
For example, consider the following report decollating mission parameters:
JOBNAME = PRTAFP1
... DO NAME = UPDATE REPORT
... DO NAME = SUMMARY REPORT
The PRTAFP1 member in the APAPARM library can contain the following:
+++UPDATE REPORT
IMM=FORM1
IDM=UPDT
+++SUMMARY REPORT
IDM=SUMM
The Hex version could appear as follows (x‘ ’ is not part of the syntax):
+++UPDATE REPORT
X'5A0010D3ABCC000002C6D6D9D4F1404040'
X'5A0010D3ABCA000002E4D7C4E340404040'
+++SUMMARY REPORT
X'5A0010D3ABCA000002C6D6D9D4F1404040'
In this example, the UPDATE REPORT requires a special Copy Group and a special Page Format. The SUMMARY REPORT requires only a special Page Format. The SUMMARY REPORT uses the default Copy Group of the active FORMDEF while printing.
Parent Topic |