Processing

The REPORT SOURCEID command checks the SYSMOD entries in a zone and reports on any source IDs found in those entries. The resulting output can be used to list the SYSMOD entries associated with the source IDs that were found.

SMP/E first verifies that each target and distribution zone specified on the ZONES operand is defined in the global zone. The zones and ZONESETs specified on the ZONES operand (including the global zone) are used to create a list of zones to be reported on. For each specified value, SMP/E first checks for a ZONESET with the same name. If none is found, SMP/E checks for a zone with the same name. If a zone is specified separately and is also part of a ZONESET, it is only reported on once.

The zones are opened for read access. If NOPUNCH was not specified, the SMPPUNCH data set is also opened.

For each zone to be reported on, SMP/E checks all the SYSMOD entries in that zone to see if they contain source IDs.

For each SYSMOD entry containing a source ID, SMP/E saves the SOURCEID value and the SYSMOD ID.
If a SYSMOD entry contains multiple source IDs, SMP/E saves all its SOURCEID values. It also saves an indicator so the SOURCEID report can note that the SYSMOD has multiple source IDs.
If a SYSMOD is in error, it is not considered installed. As a result, SMP/E ignores any source IDs associated with that SYSMOD.

SMP/E then writes a SOURCEID report for each zone specified by the ZONES operand.

If SYSMODIDS was specified on the REPORT SOURCEID command, the report includes the IDs of the SYSMODs associated with each SOURCEID value found in the zone.
If SYSMODIDS was not specified on the REPORT SOURCEID command, the report includes all the SOURCEID values found in the zone, but not the IDs of the SYSMODs associated with those source IDs.

In addition, if NOPUNCH was not specified, SMP/E writes commands to the SMPPUNCH data set to list the SYSMODs associated with the source IDs that were found. Finally, SMP/E closes all the data sets.

If any of the following occurs, SMP/E issues an error message, and REPORT SOURCEID processing fails:

A zone, ZONESET, or zone in a ZONESET specified on the ZONES operand (other than the global zone) is not defined in the global zone.
NOPUNCH was not specified, but there is no definition for the SMPPUNCH data set.