- ASSEM
- specifies the names of modules to be assembled in addition to
those modules named as GENASM subentries in the MAC entry. The source
for the assemblies is the ASSEM entry, SRC entry, or DISTSRC member
whose name matches the specified ASSEM value. SMP/E looks for a match—first
with an ASSEM entry, then with a SRC entry, and finally with an entry
in the DISTSRC data set—and uses the first match it finds. The source
must either be known to SMP/E at the time the ASSEM operand is encountered
on the ++MAC statement, or be included in the same SYSMOD.
Note: - APPLY and ACCEPT processing place the specified names into the
SYSMOD entry created on the target zone and distribution zone.
- If the object deck for the element specified on the ASSEM operand
is also provided by the SYSMOD, the assembly may not occur. (See SMP/E for z/OS Commands for
more information.)
- DELETE
- specifies that the macro and alias names are to be removed from
the target libraries, distribution libraries, and SMP/E data sets.
Note: - DELETE is mutually exclusive with all other operands except DISTLIB
and VERSION.
- If the element statement is in a base function, you may want to
use the DELETE operand on the ++VER MCS to delete the previous release,
rather than on the element statement to delete a specific element.
- DISTLIB
- specifies the ddname of the distribution library for the specified
macro.
Note: - DISTLIB must be specified if the macro has not
been previously recorded on the target zone or distribution zone.
If a MAC entry already exists in the target zone or distribution zone
and the value currently in that entry does not match that specified
in the DISTLIB operand, the SYSMOD is not applied or accepted, unless
that SYSMOD also used the ++MOVE MCS to change the DISTLIB to that
new value.
- You cannot use SYSPUNCH as the DISTLIB. It is used by SMP/E and
other products to process assembled modules.
- DISTMOD
- specifies the ddname of the link-edit distribution library for
those modules specified in the ASSEM operand. During ACCEPT processing,
the object code from the assembler is link-edited to the library specified.
- DISTSRC
- specifies the ddname of the library containing the additional
assembly or source to be assembled. The additional assembly or source
must be specified in the ASSEM operand.
- FROMDS
- identifies the partitioned data set that contains this element.
Note: The
FROMDS operand and its DSN, NUMBER, VOL, and UNIT suboperands are
included in the MCS generated by the BUILDMCS command. IBM® does not intend the FROMDS operand to be
used in manually coded MCS.
- DSN
- specifies the dsname of the FROMDS data set. The specified data
set name must conform to standard data set naming conventions and
cannot contain parentheses. The maximum length of the entire name
is 44 characters (including the periods).
- NUMBER
- specifies a number that SMP/E is to use when assigning a name
to the SMPTLIB data set associated with this FROMDS data set. (This
is similar to the way the relative file number is used in RELFILE
processing.)
- VOL
- specifies, for an uncataloged data set, the volume serial number
of the volume containing the FROMDS data set. If specified, this volume
identifier must be from 1 to 6 alphanumeric characters.
VOL may
be omitted for a cataloged data set.
- UNIT
- specifies, for an uncataloged data set, the UNIT type containing
the FROMDS data set. If specified, the UNIT value must be from 1 to
8 characters and must conform to standard UNIT naming conventions.
SMP/E accepts any nonblank characters specified between the open and
close parentheses, up to a maximum length of 8.
UNIT may be omitted
for a cataloged data set.
Note: FROMDS is mutually exclusive with
DELETE, RELFILE, SSI, and TXLIB.
- MALIAS
- specifies the alias names for the macro in both the target system
and the distribution libraries.
Note: MALIAS must
be specified on the ++MAC MCS even if ALIAS was specified
on the COPY SELECT statement. MALIAS is required for the
RECEIVE command to properly handle aliases in RELFILEs. During RECEIVE
processing, SMP/E copies RELFILEs to SMPTLIB data sets. All element
members and their associated aliases are copied. Because JCLIN is
not processed during RECEIVE, the aliases must be identified on the
MCS to get RECEIVE to copy the aliases.
You can use
MALIAS when two or more macros that must be defined in the same zone
must have the same name for programming access. For example, you can
use MALIAS if several products have a help macro whose name must match
the name of the command processing module it describes. You can specify HELP on
MALIAS and a unique element name as the macro name.
- name
- specifies the name of the macro member in the distribution library
and, optionally, in the target system library. The name can contain
any alphanumeric characters and $, #, @, or hex C0.
- PREFIX
- specifies the first characters (prefix) of the names of modules
to be assembled in addition to those modules named as GENASM subentries
in the target zone MAC entry. The prefix values must contain no more
than 7 characters.
The full module names are determined by comparing
the prefix with the target zone or distribution zone MOD entry names.
The
source for the assembly is the ASSEM entry, SRC entry, or DISTSRC
member whose name matches a MOD entry name beginning with one of the
specified prefixes. SMP/E looks for a match—first with an ASSEM entry,
then with a SRC entry, finally with an entry in the DISTSRC data set—and
uses the first match it finds. The source must either be known to
SMP/E at the time the PREFIX operand is encountered on the ++MAC statement,
or be included in the same SYSMOD.
Note: If the object deck for
an element selected by the PREFIX operand is also provided by the
SYSMOD, the assembly may not occur. (See
SMP/E for z/OS Commands for
more information.)
- RELFILE
- identifies which relative file associated with the SYSMOD contains
this element.This
operand is required if you provide the element in RELFILE format,
rather than inline or in a TXLIB data set.
Note: RELFILE is mutually
exclusive with FROMDS and TXLIB.
- RMID
- specifies the last SYSMOD that replaced this macro. This
operand may be used only in a service-updated function, and the specified
PTF must be integrated into the function.
- SSI
- specifies eight hexadecimal digits of system status information.
This information is placed in the directory of the target system library
or SMPMTS or SMPSTS during APPLY processing, and in the distribution
library during ACCEPT processing, as four packed hexadecimal bytes
of user data. See the IEBUPDTE program description in z/OS DFSMSdfp Utilities.
Note: This
operand is ignored if text is located in a library, as is the case
when either the FROMDS, RELFILE, or TXLIB operand is specified.
- SYSLIB
- specifies the ddname of the target library, if the macro exists
in one. APPLY and RESTORE processing update this library.
Note: If
a MAC entry already exists in the target zone or distribution zone
and the value currently in that entry does not match that specified
in the SYSLIB operand, SMP/E ignores the SYSLIB value in the SYSMOD
being installed, unless that SYSMOD also used the ++MOVE MCS to change
the SYSLIB to that new value.
- TXLIB
- is the ddname of the partitioned data set containing the macro.This operand is required
if the macro is provided in a data set that the users have access
to, rather than inline or in RELFILE format.
Note: - SMPTLIB cannot be used as a value on the TXLIB operand.
- TXLIB is mutually exclusive with FROMDS and RELFILE.
- UMID
- specifies the SYSMODs that have updated this macro since
it was last replaced. This operand can be used only in a service-updated
function, and the specified PTFs must be integrated into the function.
- VERSION
- specifies one or more function SYSMODs that currently contain
the element. The function containing the ++MAC MCS will take over
ownership of the element from the specified functions.
When VERSION is
specified on an element statement, it overrides any VERSION operand
values that might be specified on the ++VER MCS.