Issuing Commands › Excluding a Private Library from Management

Excluding a Private Library from Management

You can instruct CA PMO to stop managing a private library. This can be useful when you move a library from one volume to another or when you delete a library.

Format

You instruct CA PMO to stop managing a private library with the following command:

F PMO {,EXCLPRVT=data set name} [,VOL=volser] [,AM|,NM|,NR] [,SA|,SN]
      {,EXCLPRVT=ALL}

This command has the following operands:

PMO

The CA PMO keyword.

EXCLPRVT

You specify this operand as follows:

EXCLPRVT=data set name

Tells CA PMO to stop managing the specified data set. CA PMO produces an offline report for this data set before stopping management of it, provided that you specified EXCLREPT=SA or EXCLREPT=SN in your parameter data set.

EXCLPRVT=ALL

Tells CA PMO to stop managing all private libraries. If you specify a volume, CA PMO stops managing all libraries on the volume. CA PMO produces an offline report for each library, provided that you specified EXCLREPT=SA or EXCLREPT=SN in your parameter data set.

VOL=volser

The volser is the serial number of the volume that contains the data set to be excluded. You must specify a volume serial number if CA PMO is managing multiple libraries with the same name; otherwise, CA PMO stops managing the first instance of data set name that it finds, which may be the wrong library.

AM

Prints all members of the hash table in an offline report. Otherwise, it prints only those members that have been active.

NM

CA PMO prints only the first section of the offline reports. No member list is printed.

NR

CA PMO does not produce an offline report for the library.

SA

Sorts the members listed in an offline report alphabetically, by name.

SN

Sorts the members listed in an offline report in descending order, by number of searches. This is the default if you have not specified the EXCLREPT parameter in your parameter data set.

Messages

When CA PMO> successfully processes this command, it responds:

PMO396I EXCLPRVT SUCCESSFUL FOR DSN=data set name

If CA PMO does not manage the library that you specified on this command, it responds:

PMO392I PMO DOES NOT MANAGE DSN=data set name

If CA PMO is not managing any private libraries at all, it responds:

PMO394I CA PMO IS NOT CURRENTLY MANAGING ANY PRIVATE LIBRARIES

If CA PMO issues any other messages, see the CA PMO Message Guide.

Note:

Keep the following items in mind when using the EXCLPRVT command:

• After CA PMO stops managing the library, you cannot produce any more offline reports for it. The library will no longer be listed on the PMOMON D8 screen, but it may be a candidate listed on the D9 screen.
• To have CA PMO manage this library in the future, you can add it with the F PMO,INCLPRVT command. If you do so, statistics for the library will start at 0.
• If you issue the F PMO,EXCLPRVT command for a library that CA PMO is not currently managing, CA PMO will not automatically include this library for management. To allow CA PMO to manage this library, you can include it with the F PMO,INCLPRVT command.
• The report and sort options override the EXCLREPT parameter. If you specify only a sort option, then only those members that have been active will be printed.