The select address space identifier (ASID) service scans the ASCBs
in a dump by following the pointers in the ASVT and then generates
a list of entries for selected address spaces within that dump. The
select ASID service returns a list of ASCBs meeting selection criteria.
The ASID service also creates storage maps entries for ASCBs, which
indirectly improve performance.
The following address space selection criteria describe the types
of address spaces that you might select:
- ALL
- Selects all address spaces in the dump.
- CURRENT
- Selects each address space that was active at the time the dump
was generated.
When CURRENT is selected, a storage map entry is
created for each address space selected. Each storage map entry describes
the private area of one address space selected as AREA(CURRENT).
- ERROR
- Specifies processing of trace entries for address space identifiers
(ASID) associated with tasks and/or address spaces in error. ERROR
will process trace entries for any ASIDs associated with tasks or
address spaces in error. To process just the trace entries for ASIDs
associated with tasks in error, use TCBERROR.
- TCBERROR
- Specifies processing of trace entries for ASIDs associated with
tasks in error. TCBERROR will process trace entries for any ASIDs
associated with tasks in error; TCBERROR ignores errors that pertain
to the whole address space.
Note: When you specify ERROR
and TCBERROR in the same subcommand, IPCS processes all error address
spaces, but will also identify those that are both ERROR and TCBERROR.
- ASIDLIST
- Selects a list of address spaces, a range of address spaces,
or a single address space.
- JOBLIST
- Selects address spaces associated with a list of job names.
When
JOBLIST is selected, a storage map entry is created for each address
space selected. Each storage map entry describes the private area
of one address space selected as AREA(JOB
aaaaaaaa) where
aaaaaaaa is
one of two things:
- MASTER for the master address space, ASID(1).
The system carries the name of the master address space as *MASTER*, but the asterisks cannot be used in an
IPCS data name and are removed as a special case.
- In all other cases aaaaaaaa is the job name or the name
of the started task.
Restriction: Job names are checked
to ensure that their names are valid in an IPCS data name, and, if
they are not, no storage map entries are created. However, this is
largely a theoretical concern. Use of normal system interfaces that
create address spaces causes those address spaces to be given names
that IPCS can use.
You can invoke this service by using the SELECT subcommand.