FIND

The FIND command searches the mix, disk, and tape subsystems to find items with specific attributes and reports them.

You can use the FIND command to

  • Get a report on what is in the mix.

  • Identify disks or magnetic tapes.

  • Get reports about disk drives or magnetic tapes.

Syntax

<object type>

<selection attribute>

<wild card>

<delim>

One of the following characters

/   \   I   ~   !   @   #   $   %   ^   &   *   '  

The first delimiter must be the same as the second delimiter.

<date value>

  • <month> is two digits representing the selected month.

  • <day> is two digits representing the day of the month.

  • <year> is four digits representing the year.

  • TODAY selects today's date.

  • <integer value> is used to adjust today's date by the number of specified days.  A minus sign must precede the value.

Explanation

FIND LIBS <selection attribute>

Finds library mix entries that match the selection attribute.  For each library entry, this command returns the mix number and name as well as the selection attribute.

The following table describes the library attributes that can be used in this command.

Attribute Name

Type

Description

ACCESS

String

Process access code

ASDSINUSE

Integer

Number of ASDs in use

CHARGE

String

Process charge code

CODEFILE

String

Title of the object code file

CODEMEMORY

Integer

Memory used by the segment dictionary of the process

COMPILER

Boolean

TRUE if the process is a compiler

CONTROL

Boolean

TRUE if the process is a control program

CPURATE

Integer

Recent processor usage of the process as a percentage

CPUTIME

Integer

Process processor time

ELAPSEDTIME

Integer

Process elapsed time

IDENTITY

String

Process identity (from MP <code file> + IDENTITY)

INITPBITS

Integer

Count of initial presence bits

INITPBITTIME

Integer

Processor time used for initial presence bits

IOTIME

Integer

Process I/O time

JOBNO

Integer

Process job number

LOCKED

Boolean

TRUE if the process is a locked program

MEMORY

Integer

Process total memory

MIXNO

Integer

Process mix number

MPID

String

The MPID attribute of the process

NAME

String

Process name

ORGLSN

Integer

LSN of originating station

ORGSTATION

String

Station name where process originated

OTHERPBITS

Integer

Count of non-initial presence bits

OTHERPBITTIME

Integer

Processor time used for non-initial presence bits

PRIORITY

Integer

Process priority

PU

Boolean

TRUE if the process has PU privilege from the MP + PU command

QUEUE

Integer

The job queue, if any, that is the source of the process

READYQTIME

Integer

Process ready queue time

RELEASEID

String

Release identity of process

SAVECODEMEMORY

Integer

Save memory used by the segment dictionary

SAVEMEMORY

Integer

Save memory in use by the process

SECADMIN

Boolean

TRUE if the process has SECADMIN privilege from the MP + SECADMIN command

SUPPRESSED

Boolean

TRUE if the process is suppressed

TASKING

Boolean

TRUE if the process has TASKING privilege from the MP + TASKING command

USER

String

Process user code

FIND MIX <selection attribute>

Finds all mix entries that match the selection attribute. This command searches mix entries of all types, including library mix entries. For each mix entry, this command returns the mix number, job number, and name as well as the selection attribute.

The mix attributes that can be specified are the same as the library attributes that were listed previously.

FIND MT <selection attribute>

Finds all tape drives that match the selection attribute.   For each tape drive, this command returns the unit number, serial number, reel number, and name as well as the selection attribute.

Use the FIND command and the following attributes to query mounted tapes.

Attribute Name

Type

Description

MIX

Integer

Mix number of the program using the tape

NAME

String

Tape name

SCRATCH

Boolean

TRUE if the tape mounted is a scratch tape

SCRATCHPOOL

String

Scratch pool of the mounted tape

SERIAL

String

Serial number

TOTALREADS

Integer

Total number of reads of the tape on the drive

TOTALWRITES

Integer

Total number of writes to the tape on the drive

UNITNO

Integer

Unit number of the tape drive

FIND PK <selection attribute>

Finds all disks that match the selection attribute. All FIND PK commands return the unit number, serial number, family index, and name in addition to the other selection attribute that was specified. Use the FIND command and the following attributes to query disk packs.

Attribute Name

Type

Description

AVAILGB

Integer

Available space on a pack, in gigabytes

AVAILSECTS

Integer

Available space on a pack, in sectors

BASEUNIT

Integer

Unit number of a base pack

CACHED

Boolean

TRUE if unit is being cached

CAPACITY

Integer

Capacity of a pack, in sectors

CAPACITYGB

Integer

Capacity of a pack, in gigabytes

CERTIFIED

Boolean

Certification status of a mirrored pack

CERTTIMESTAMP

Date

Timestamp of mirror certification

DISKKEY

String

Name of the Disk Key that was used to encrypt this unit

ECRYPTION

Boolean

True if the unit is encrypted

FAMILYINDEX

Integer

Index of family member

IOTIMER

Integer

Timeout value in effect for READ and WRITE operations on a pack

LARGESTSZSECTS

Integer

Largest single area available on a pack

LOCALACCESS

Boolean

TRUE if unit uses local system access directory

MIRRORED

Boolean

TRUE if unit is a member of a mirrored set

NAME

String

Pack name

ONLINE

Boolean

TRUE if unit is on line

QUEUEDEPTH

Integer

Number of I/Os waiting for a pack

REMOTEDISK

Boolean

TRUE if unit is a remote disk device

SCRATCH

Boolean

Purged pack unit

SERIAL

String

Serial number of a pack

SHARED

Boolean

TRUE if unit is shared

SITENAME

String

StoreSafe site name of a StoreSafe named pack

SPARE

Boolean

TRUE if unit has been entered in the spare disk pool (as either a free spare or an in-use spare)

STORESAFESTATUS

String

Status of StoreSafe named units and volumes

TOTALIOS

Integer

Total number of reads from a pack and writes to a pack

TOTALREADS

Integer

Total number of reads from a pack

TOTALWRITES

Integer

Total number of writes to a pack

TYPE

String

Pack type:

B = base pack

C = continuation pack

UNITNO

Integer

Unit number

VSSTYPE

Integer

VSS Format:

0 = 180-byte disk

1= VSS-1 disk

2 = VSS-2 disk

3 = VSS-3 disk

FIND <object type> <Boolean attribute> = TRUE

FIND <object type> <Boolean attribute> = FALSE

FIND <object type> <Boolean attribute>

A value of TRUE reports objects for which the attribute has a value of TRUE.

A value of FALSE reports objects for which the attribute has a value of FALSE.

If neither TRUE nor FALSE is specified, the value is assumed to be TRUE. For example, FIND MIX PU reports all the privileged programs in the mix.

Note: You cannot use the SORT option with Boolean attributes.

FIND <object type> <integer attribute> <relation> <integer value>

Finds objects with a integer attribute that satisfies the relation. For example, FIND MIX MEMORY > 5000 returns all mix entries using greater than 5000 words of memory.  Following are the possible relations.

Relation

Meaning

=

Equal to

<>

Not equal to

>

Greater than

>=

Greater than or equal to

<

Less than

<=

Less than or equal to

FIND <object type> <string attribute> <wild-card string>

FIND <object type> <string attribute> <> <wild-card string>

Finds objects with a string attribute matching the wild-card string. If the optional <> token is present, the selection includes any entry where the attribute does not match the wild-card string. The string can include the following special characters.

Character

Description

Equal sign ( = )

Matches any sequence of characters

Question mark ( ? )

Matches any single character

Tilde ( ~ )

Matches any sequence of characters except a slash ( /)

The wild-card string is automatically uppercased, except for characters enclosed in quotation marks, and the system stops processing the string when it encounters a space character.

For example, if you enter the following syntax, the system returns entries that contain the string "SYSTEM": 

FIND MIX NAME =system=

If you enter the following syntax, the system returns entries that contain the string "system": 

FIND MIX NAME LIT ^=system=^

FIND <object type> <selection attribute> SORT

FIND <object type> <selection attribute> SORT +

FIND <object type> <selection attribute> SORT −

The SORT option causes the output to be sorted. SORT or SORT + sorts the output in ascending order. SORT − sorts the output in descending order.

The SORT option cannot be used with a Boolean selection attribute.

FIND <object type> <selection attribute> ALL

If information in the right-hand column of a SHOW display is truncated to fit your screen, you can specify the ALL parameter to use a display format that displays one attribute name and its value per line.

Examples

Example 1

The following output from the FIND MIX command consists of one line per program. The first two items on the output display are the mix and job numbers, followed by the item used for the selection, and then the program name.

The exception to this format is the Boolean attributes. Their values are not shown in the display because they all have the required value, so the display for FIND MIX PU reports all the privileged programs showing mix number, job number, and name only. 

FIND MIX MEMORY > 60000
MixNo-JobNo---Memory-Name-------------------------------
7397  7397   77,015 (RPC)SYSTEM/ONC/RPCSUPPORT ON MCPS
7388  7388  537,553 (RPC)SYSTEM/WIN/RPCSUPPORT/DIAGNOSTICS
                      /52103/M ON MCPS
 704   702 2,028,216 *SYSTEM/NEWP ON SYS00
6482  6482   191,961 *SYSTEM/MARC/COMMANDER
6459  6459   407,514 *SYSTEM/DSSSUPPORT/DIAGNOSTICS
6454  6454   146,093 *SYSTEM/CNSOBJMGR/51008
6450  6450   227,883 *SYSTEM/SNMPAGENT/51008
6438  6438   105,913 *SYSTEM/CNS/TRANSLATION/51008
6434  6434   106,045 *SYSTEM/CCF/PCM/PIPES
6420  6420   543,940 *SYSTEM/CNS/MANAGERS/51008
6417  6417 1,329,226 *SYSTEM/COMS
6579  6417    99,589 *COMS/ODT/DRIVER
6403  6403    73,943 *SYSTEM/CCF
6436  6403    99,591 *SYSTEM/CCF/PCM/LOGON
6435  6403   135,796 *SYSTEM/CCF/PCM/TCPIP
6433  6403   113,252 *SYSTEM/CCF/PCM/TERM
6431  6403   104,879 CCF/CUCIPCM
6380  6380   504,384 *SYSTEM/BNA/SUPPORT/51008

Example 2

If SORT − (minus sign) is appended to the end of the command, the list is sorted in descending order of the selected item: 

FIND MIX MEMORY > 100000 SORT-  
MixNo--JobNo---Memory--Name----------------------------------
  704    702 2,062,340 *SYSTEM/NEWP ON SYS00
 6378   6378 1,667,773 *SYSTEM/TCPIPSUPPORT/51008/DIAG
 6417   6417 1,329,226 *SYSTEM/COMS
 6420   6420    543,940 *SYSTEM/CNS/MANAGERS/51008
 7388   7388    537,553 (RPC)SYSTEM/WIN/RPCSUPPORT/DIAGNOSTICS/
                         52103/M ON MCPS
 6380   6380    504,384 *SYSTEM/BNA/SUPPORT/51008
 6459   6459    407,514 *SYSTEM/DSSSUPPORT/DIAGNOSTICS
 6314   6314    321,379 *SYSTEM/KERBEROS/SUPPORT
 6450   6450    227,883 *SYSTEM/SNMPAGENT/51008
 6292   6292    216,771 *SYSTEM/PRINT/SUPPORT
 6482   6482    191,961 *SYSTEM/MARC/COMMANDER
 6376   6376    173,638 *SYSTEM/LPPSUPPORT/DIAGNOSTICS
 6454   6454    146,093 *SYSTEM/CNSOBJMGR/51008
 6435   6403    135,796 *SYSTEM/CCF/PCM/TCPIP
 6293   6293    129,792 *SYSTEM/GSSAPI/SUPPORT
 6296   6296    123,920 *SYSTEM/NETWORKSUPPORT/DIAGNOSTICS

Example 3

This example reports all packs on the system with a name starting with the string SYS: 

FIND PK NAME   SYS=
   UnitNo-Serial-Familyindex-Name----------------------
         47 203152                     1 SYS00
         49 209088                     1 SYS511

Example 4

This example reports all packs on the system with unit numbers less than or equal to 50: 

FIND PK UNITNO   <= 50
   UnitNo-Serial-Familyindex-Name----------------------
         44 192045                     1 PACK
         45 427321                     2 DISK
         47 190343                     1 DMSIITEST

Example 5

This example reports units with less than 300,000 sectors of available space: 

FIND PK AVAILSECTS   < 300000
   UnitNo-Serial-Familyindex-AvailSects-Name-----------
         44 192045              1     250,827 PACK

Example 6

This example reports the unit and serial number of the mounted tape: 

FIND MT SCRATCH
      ---UnitNo--Serial----Name----------------------
                 45       PHIL        

Example 7

The following example uses the ALL option to display mix entries whose RELEASEID matches the string =DIAGNOSTICS=, without truncation: 

   FIND MIX RELEASEID =DIAGNOSTICS=   ALL    
  --------------------------------------------------------------
  MixNo: 38018
     JobNo: 38016
     ReleaseID: CANDE-051.1A.4 (51.189.8015)<OPTIONAL DIAGNOSTICS>
     Name: *SYSTEM/CANDE ON SUPPORT
  --------------------------------------------------------------  

Example 8

The following example reports a mirrored pack that has been certified: 

FIND PK CERTIFIED
   UnitNo-Serial-FamilyIndex-Type-Name
     100   000100             1    B     OASIS

Example 9

The following example reports the certification timestamp for all certified mirrors which were certified today: 

FIND PK CERTTIMESTAMP = TODAY
UnitNo-Serial-FamilyIndex-Type-Certification Date&TimeStamp-Name
  180   000180             1   B      Mon, May 13, 2002 @ 14:40:03 T180.
Prev  Up  Next
FILELOCKTLIMIT (File Lock Time Limit)  Home  FM (Form Message)