Use this field-level keyword on the second (and last) field in the subfile
record format for a message subfile. This field contains the name of
the program message queue used by the OS/400 program to build a message
subfile. In addition, SFLPGMQ can be specified on the subfile control
record format when the SFLINZ keyword is specified on the subfile control
record format.
The format of the keyword is:
SFLPGMQ([10] | [276])
When 10 is specified, SFLPGMQ generates a 10-byte field. 10 is the
default.
When 276 is specified, SFLPGMQ generates a 276-byte field.
This field is predefined as a character data type, hidden field. The
following rules apply:
- The field name and the SFLPGMQ keyword and parameters are the only DDS you
can specify for this field.
- If the name of the program message queue placed in this field at
processing time is less than the field length (10 or 276 bytes), it must be
left-adjusted and padded with blanks.
For Integrated Language Environment* (ILE*) programs using the 276-byte
parameter value, the format of the field data must be as follows:
- The first 256 bytes contains the ILE call message queue name. The
call message queue name is the same as the ILE procedure name. The name
must be left-adjusted and padded with blanks.
- Bytes 257 through 266 will optionally contain the ILE module name.
The name, when specified, must be left-adjusted and padded with blanks.
If no module name is provided, these bytes must be set to blanks.
- Bytes 267 through 276 will optionally contain the name of the ILE bound
program name. The name, when specified, must be left-adjusted and
padded with blanks. If no bound program name is provided, these bytes
must be set to blanks.
Notes:
- If a parameter value of 10 is used on SFLPGMQ and an ILE procedure name
longer than 10 bytes is placed into this field at processing time, the
procedure name is truncated to 10 bytes. The results will be
unpredictable.
- If a parameter value of 276 is used on SFLPGMQ and a program message queue
name is placed into this field at processing time, bytes 257 through 276 must
be set to blanks. If these bytes are not blank, the system assumes that
a call message queue name has been given and will not find the specified
program message queue.
- If the SFLPGMQ keyword is specified on both the subfile and subfile
control record, the SFLPGMQ parameter values must match. However,
different subfiles within the same file can use different SFLPGMQ parameter
values.
This field is required on the subfile record format (identified by the SFL
keyword) to build the subfile one message at a time through multiple output
operations to the subfile record format.
You can also specify this field on the subfile control record format
(identified by the SFLCTL keyword) to build the subfile all at once through a
single output operation to the subfile control record. Specify option
indicators with the SFLINZ keyword to control the way the subfile is
built.
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.