Print Admin Domain MRE (PRTCADMRE)

Where allowed to run: All environments (*ALL)
Threadsafe: Yes

The Print Cluster Administrative Domain Monitored Resource Entry (PRTCADMRE) command is used to show information about the monitored resources in a cluster administrative domain. The information can be printed or directed to a database output file (OUTFILE).

Restrictions:

For PowerHA version 2.1 or less, the command must be run on a cluster node that is part of the administrative domain whose monitored resources are to be selected.
For PowerHA version 2.2 or greater, this command can be called from any active cluster node.

Top

Parameters

Keyword	Description	Choices	Notes
ADMDMN	Cluster administrative domain	Name	Required, Positional 1
CLUSTER	Cluster	Name, *	Optional
RESOURCE	Monitored resource	Character value, *ALL	Optional
RSCLIB	Library	Name, *ALL	Optional
RSCTYPE	Monitored resource type	Single values: ALL Other values (up to 19 repetitions): ASPDEV, AUTL, CLS, ENVVAR, ETHLIN, JOBD, NETA, NWSCFG, NWSD, NWSHDEV, NWSSTG, OPTDEV, PRTDEV, SBSD, SYSVAL, TAPDEV, TCPA, TRNLIN, USRPRF	Optional
RSCGLBSTS	Resource global status	Single values: ALL Other values (up to 6 repetitions): ADDED, CONSISTENT, ENDED, FAILED, INCONSISTENT, *PENDING	Optional
DETAIL	Information detail	ALL, RSC, *ATTR	Optional
OUTPUT	Output	PRINT, OUTFILE	Optional
OUTFILE	File to receive output	Qualified object name	Optional
	Qualifier 1: File to receive output	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
OUTMBR	Output member options	Element list	Optional
	Element 1: Member to receive output	Name, *FIRST
	Element 2: Replace or add records	REPLACE, ADD

Top

Cluster administrative domain (ADMDMN)

Specifies the cluster administrative domain which is monitoring resources.

This is a required parameter.

name: Specify the cluster administrative domain.

Top

Cluster (CLUSTER)

Specifies the cluster the administrative domain is in.

*: The name of the cluster that exists on the system is used.
name: Specify the name of the cluster.

Top

Monitored resource (RESOURCE)

Specifies the monitored resource to be selected.

*ALL: All resources will be selected for output.
name: Specify the name of the monitored resource.

Top

Library (RSCLIB)

Specifies the library for the monitored resource.

Note: For resources that do not reside in a library, this parameter is ignored.

*ALL: Resources from all libraries will be selected for output.
name: Specify the name of the library for the resource.

Top

Monitored resource type (RSCTYPE)

Specifies the type of resource to be selected.

Single values

*ALL: All resource types are to be selected

Other values (up to 19 repetitions)

*ASPDEV: Only auxiliary storage pool device resource types are to be selected.
*AUTL: Only authorization list resource types are to be selected.
*CLS: Only class resource types are to be selected.
*ENVVAR: Only environment variable resource types are to be selected.
*ETHLIN: Only Ethernet line description resource types are to be selected.
*JOBD: Only job description resource types are to be selected.
*NETA: Only network attribute resource types are to be selected.
*NWSCFG: Only network server configuration resource types are to be selected.
*NWSD: Only network server description resource types are to be selected.
*NWSHDEV: Only network server host adapter device descriptions resource types are to be selected.
*NWSSTG: Only network server storage resource types are to be selected.
*OPTDEV: Only optical device description resource types are to be selected.
*PRTDEV: Only printer device description resource types are to be selected.
*SBSD: Only subsystem description resource types are to be selected.
*SYSVAL: Only system value resource types are to be selected.
*TAPDEV: Only tape device description resource types are to be selected.
*TPCA: Only Only TCP/IP attribute resource types are to be selected.
*TRNLIN: Only token ring line description resource types are to be selected.
*USRPRF: Only user profile resource types are to be selected.

Top

Resource global status (RSCGLBSTS)

Specifies the global status a resource must have in order for the information to be selected.

*ALL: The resource's global status can have any value.

Other values (up to 6 repetitions)

*ADDED: The monitored resource entry and its attributes have been added to the monitored resource directory in the cluster administrative domain but has not yet been synchronized because the domain is not active.
*CONSISTENT: The values for all the resource's attributes monitored by the system are the same within the active cluster administrative domain.
*ENDED: The cluster administrative domain has been ended and synchronization stopped so it is not known whether the resource is consistent or not.
*FAILED: The resource is no longer being monitored by the cluster administrative domain and the monitored resource entry should be removed.
*INCONSISTENT: One or more of the monitored attributes for a monitored resource entry are not set to the value known by the cluster administrative domain on one or more nodes in the domain.
*PENDING: The values of the monitored attributes are in the process of being synchronized across the cluster administrative domain.

Top

Information detail (DETAIL)

Specifies the information detail provided. *ALL is valid only if information is printed. Only one value, *RSC or *ATTR, can be specified if information is stored in a database output file.

*ALL: All of the monitored resource information is to be selected
*RSC: Resource information is to be selected.
*ATTR: The resource's attribute information is to be selected.

Top

Output (OUTPUT)

Specifies where the output from the command is sent.

*PRINT: The output is printed with the job's spooled output.
*OUTFILE: The output is directed to the database file specified for the file to receive output (OUTFILE) parameter.

Top

File to receive output (OUTFILE)

Specifies the database file to which the output of the command is directed. If the file does not exist, this command creates a database file in the specified library. If the file is created, the public authority for the file is the same as the create authority specified for the library in which the file is created. Use the Display Library Description (DSPLIBD) command to show the library's create authority.

Qualifier 1: File to receive output

name: Specify the name of the database file to which the command output is directed.

Qualifier 2: Library

*LIBL: The library list is used to locate the file. If the file is not found, one is created in the current library. If no current library exists, the file will be created in the QGPL library.
*CURLIB: The current library for the thread is used to locate the file. If no library is specified as the current library for the thread, the QGPL library is used.
name: Specify the name of the library.

Note: If a new file is created and *RSC is specified for the Information detail (DETAIL) parameter, the system uses QAHAPMRSC in QHASM with a format name QHAPMRSC as a model.

If a new file is created and *ATTR is specified for the Information detail (DETAIL) parameter, the system uses QAHAPMATTR in QHASM with a format name QHAPMATTR as a model.

Top

Output member options (OUTMBR)

Specifies the name of the database file member that receives the output of the command.

Element 1: Member to receive output

*FIRST: The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified for the File to receive output (OUTFILE) parameter. If the member already exists, you have the option to add new records to the end of the existing member or clear the member and then add the new records.
name: Specify the name of the file member that receives the output. If it does not exist, the system creates it.

Element 2: Replace or add records

*REPLACE: The system clears the existing member and adds the new records.
*ADD: The system adds the new records to the end of the existing records.

Top

Examples

Example 1: Printing Attributes for All Monitored Resources

PRTCADMRE   ADMDMN(MYADMDMN)  CLUSTER(*)
            DETAIL(*ATTR)  OUTPUT(*PRINT)

This command produces a spooled file for the monitored resources for the administrative domain named MYADMDMN. Administrative domain MYADMDMN must exist in the cluster for the node system that this command is run on. The spooled file contains information about all monitored resources and their attributes.

Example 2: Creating a Database File for Monitored Resources

PRTCADMRE   ADMDMN(MYADMDMN)  CLUSTER(EXAMPLE)
            DETAIL(*RSC)  OUTPUT(*OUTFILE)
            OUTFILE(QGPL/RSCLIST)

This command produces a database file named RSCLIST in library QGPL that contains records for all the resources being monitored in the administrative domain named MYADMDMN in the cluster named EXAMPLE.

Top

Error messages

*ESCAPE Messages

CPFBB02: Cluster &1 does not exist.
CPFBB0F: Cluster resource group &1 does not exist in cluster &2.
HAE000A: All cluster command user spaces busy.
HAE004F: &1 command failed.

Top