A wildcard is a character used to represent an unspecified resource
name or an unspecified part of a resource name. It is used by the VTAM® operator to broaden the scope
of a display or to find the name of a resource. Depending on the value
of the DSPLYWLD start option, the use of wildcards might be allowed
in the value specified for the ID operand of the following DISPLAY
commands:
- DISPLAY APPLS
- DISPLAY CDRMS
- DISPLAY CDRSCS
- DISPLAY CLSTRS
- DISPLAY CPCP
- DISPLAY GRAFFIN
- DISPLAY GROUPS
- DISPLAY LINES
- DISPLAY RSCLIST
- DISPLAY STATIONS
- DISPLAY TERMS
- DISPLAY TGPS
- DISPLAY TOPO
- DISPLAY TRACES
Note: For
most of the referenced DISPLAY commands, the ID operand identifies
the name of a major node. The use of wildcards in the value of the
ID operand does not extend the display to include subordinate nodes.
To display the subordinate nodes, use the DISPLAY RSCLIST command
with the IDTYPE operand.
You cannot specify wildcards in the value of the ID operand on
the DISPLAY TOPO command if you specify LIST=ALL or LIST=SUMMARY.
Depending on the value of the DSPLYWLD start option, you might
be able to specify wildcards in the value you specify for the ORIG,
VRN, and DEST operands of the DISPLAY TOPO,LIST=UNRCHTIM command.
You can specify wildcards in the value for the EXCLUDE operand
of the DISPLAY RSCLIST command, and in the values for the LU and GNAME
operands of the DISPLAY GRAFFIN command.
Attention: Specifying a wildcard name might degrade performance
because VTAM checks every resource
of a particular type in the network, depending on the command and
operands issued.
VTAM recognizes two wildcard
characters for these commands:
- asterisk (*)
- Represents a string of unspecified characters
- question mark (?)
- Represents a single unspecified character.
The following examples show how to use wildcard names with the
DISPLAY RSCLIST command:
- ID=*
- Displays all resource names
- ID=APP*
- Displays resource names that start with APP
- ID=*01
- Displays resource names that end with 01
- ID=APPL*01
- Displays resource names that begin with APPL and
end with 01
- ID=APPL0??
- Displays resource names that begin with APPL0 followed
by exactly two characters
- ID=A*P?1
- Displays resource names that start with A and
end with Px1 where x is
any single character
- ID=?APP*
- Displays resource names that begin with any single character followed
by APP and followed by any other characters
- ID=??*
- Displays resource names of two or more characters
- ID=(AA00,APP*,*01)
- Displays the first resource, then all resource names that start
with APP, then all resources names that
end with 01.
The following examples show how to use wildcard names with network-qualified
names (DISPLAY RSCLIST, DISPLAY TOPO, and DISPLAY TRACES,TYPE=NODES
commands):
- ID=NETA.APP*
- Displays resource names in NETA that begin with APP
- ID=NET*.A*
- Displays resource names that start with A and
have a network-qualified name that begins with NET
- ID=N*A.A01
- Displays all resources with the name A01 with
a network-qualified name that begins with N and
ends with A
- ID=NETA.*
- Displays all resources in NETA
- ID=*.??
- Displays resources in any network with exactly two characters
- ID=(A*,NETB.AP*,APPL2,*.T??)
- Displays:
- Resource names that begin with A
- Resource names in NETB that begin with AP
- APPL2
- Resources in any network whose name begins with T followed
by exactly two characters
Restriction: The CPNAME and FIRSTCP operands of the D
NET,RTPS operator command allow a restricted use of the asterisk.
Their use of the asterisk might be only of the form netid.*, and is
not governed by the DSPLYWLD start option. The following two examples
show how to use the asterisk for the D NET,RTPS operands:
- CPNAME=NETA.*
- Only HPR pipes whose destination CP is in the netid of NETA are
displayed.
- FIRSTCP=NETB.*
- Only HPR pipes whose first hop is to a CP with a netid of NETB
are displayed.