HP OpenVMS Systems Documentation

Content starts here

OpenVMS System Management Utilities Reference Manual


Previous Contents Index

SHOW/IDENTIFIER

Displays information about an identifier, such as its name, value, attributes, and holders, on the current SYS$OUTPUT device.

Format

SHOW/IDENTIFIER [id-name]


Parameter

id-name

Specifies an identifier name. The identifier name is a string of 1 to 31 alphanumeric characters. The name can contain underscores and dollar signs. It must contain at least one nonnumeric character. If you omit the identifier name, you must specify /USER or /VALUE.

Qualifiers

/BRIEF

Specifies a brief listing in which only the identifier name, value, and attributes are displayed. The default format is /BRIEF.

/FULL

Specifies a full listing in which the names of the identifier's holders are displayed along with the identifier's name, value, and attributes.

/USER=user-spec

Specifies one or more users whose identifiers are to be displayed. The user-spec can be a user name or a UIC. You can use the asterisk wildcard character (*) to specify multiple UICs or all user names. UICs must be in the form [*,*], [n,*], [*,n], or [n,n]. A wildcard user name specification (*) displays identifiers alphabetically by user name; a wildcard UIC specification ([*,*]) displays them numerically by UIC.

/VALUE=value-specifier

Specifies the value of the identifier to be listed. The following formats are valid for the value-specifier:
IDENTIFIER:n An integer value in the range of 65,536 to 268,435,455. You can also specify the value in hexadecimal (precede the value with %X) or octal (precede the value with %O).

To differentiate general identifiers from UIC identifiers, %X80000000 is added to the value you specify.

UIC:uic A UIC value in the standard UIC format.

See also the screen control qualifiers listed under the SHOW command:

/EXACT

/HIGHLIGHT[=keyword]

/NOHIGHLIGHT (default)

/PAGE[=keyword]

/NOPAGE (default)

/SEARCH=string

/WRAP

/NOWRAP (default)


Description

The SHOW/IDENTIFIER command displays identifier names, values, attributes, and holders in various formats depending on the qualifiers specified. Two of these formats are illustrated in the following examples.

Examples

#1

UAF> SHOW/IDENTIFIER/FULL INVENTORY
      

This command would produce output similar to the following example:


Name               Value           Attributes
INVENTORY          %X80010006      NORESOURCE NODYNAMIC
  Holder            Attributes
  ANDERSON          NORESOURCE NODYNAMIC
  BROWN             NORESOURCE NODYNAMIC
  CRAMER            NORESOURCE NODYNAMIC
#2

UAF> SHOW/IDENTIFIER/USER=ANDERSON
      

This command displays the identifier associated with the user ANDERSON, as follows:



Name                              Value           Attributes
ANDERSON                          [000300,000015] NORESOURCE NODYNAMIC

The identifier is shown, along with its value and attributes. Note, however, that this is the same result you would produce had you specified ANDERSON's UIC with the following forms of the command:


UAF> SHOW/IDENTIFIER/USER=[300,015]


UAF> SHOW/IDENTIFIER/VALUE=UIC:[300,015]

SHOW/PROXY

Displays all authorized proxy access for the specified remote user.

Format

SHOW/PROXY node::remote-user


Parameters

node

Specifies the name of a network node in the network proxy authorization file. The asterisk wildcard character (*) is permitted in the node specification.

remote-user

Specifies the user name or UIC of a user on a remote node. The asterisk wildcard character (*) is permitted in the remote-user specification.


Qualifiers

/OLD

Directs AUTHORIZE to display information from NETPROXY.DAT rather than the default file NET$PROXY.DAT.

If someone modifies the proxy database on a cluster node that is running an OpenVMS system prior to Version 6.1, you can use the /OLD qualifier to display the contents of the old database, NETPROXY.DAT.

See also the screen control qualifiers listed under the SHOW command:

/EXACT

/HIGHLIGHT[=keyword]

/NOHIGHLIGHT (default)

/PAGE[=keyword]

/NOPAGE (default)

/SEARCH=string

/WRAP

/NOWRAP (default)


Description

The SHOW/PROXY command displays the first 255 characters of a node name although the command can handle a maximum of 1024 characters.

Examples

#1

UAF> SHOW/PROXY SAMPLE::[200,100]

 Default proxies are flagged with an *

SAMPLE::[200,100]
     MARCO *                              PROXY2
     PROXY3
      

The command in this example displays all authorized proxy access for the user on node SAMPLE with a UIC of [200,100]. The default proxy account can be changed from MARCO to PROXY2 or PROXY3 with the MODIFY/PROXY command.

#2

UAF> SHOW/PROXY *::*

 Default proxies are flagged with (D)

TAO:.TWA.RANCH::MARTINEZ
    MARTINEZ (D)                        SALES_READER

UAF> show/proxy/old *::*

 Default proxies are flagged with (D)

RANCH::MARTINEZ
    MARTINEZ (D)                        SALES_READER
      

The command in this example displays information about local authorized proxy access on a system running DECnet-Plus. The first command draws information from the file NET$PROXY.DAT. By including the /OLD qualifier on the SHOW/PROXY command, AUTHORIZE displays information from the file NETPROXY.DAT.

SHOW/RIGHTS

Displays the identifiers held by the specified identifiers or, if /USER is specified, all identifiers held by the specified users.

Format

SHOW/RIGHTS [id-name]


Parameter

id-name

Specifies the name of the identifier associated with the user. If you omit the identifier name, you must specify the /USER qualifier.

Qualifier

/USER=user-spec

Specifies one or more users whose identifiers are to be listed. The user-spec can be a user name or a UIC. You can use the asterisk wildcard character (*) to specify multiple UICs or all user names. UICs must be in the form [*,*], [n,*], [*,n], or [n,n]. A wildcard user name specification (*) or wildcard UIC specification ([*,*]) displays all identifiers held by users. The wildcard user name specification displays holders' user names alphabetically; the wildcard UIC specification displays them in the numerical order of their UICs.

See also the screen control qualifiers listed under the SHOW command:

/EXACT

/HIGHLIGHT[=keyword]

/NOHIGHLIGHT (default)

/PAGE[=keyword]

/NOPAGE (default)

/SEARCH=string

/WRAP

/NOWRAP (default)


Description

Output displayed from the SHOW/RIGHTS command is identical to that written to RIGHTSLIST.LIS when you use the LIST/RIGHTS command.

Example


UAF> SHOW/RIGHTS ANDERSON
      

This command displays all identifiers held by the user ANDERSON. For example:


Name                Value           Attributes
INVENTORY           %X80010006      NORESOURCE NODYNAMIC
PAYROLL             %X80010022      NORESOURCE NODYNAMIC

Note that the following formats of the command produce the same result:


SHOW/RIGHTS/USER=ANDERSON


SHOW/RIGHTS/USER=[300,015]


Chapter 6
AUTOGEN Command Procedure

6.1 AUTOGEN Description

The AUTOGEN command procedure (SYS$UPDATE:AUTOGEN.COM) sets appropriate values for system parameters and sizes for system page, swap, and dump files. AUTOGEN runs automatically when you install or upgrade the operating system.

In addition, you can use AUTOGEN to reset system parameter values, system file sizes, or both. The new values and file sizes take effect the next time the system is booted.

Compaq recommends that you run AUTOGEN on a weekly basis to adjust system parameters according to your system's work load. For a list and description of all system parameters, refer to

AUTOGEN executes in phases with each phase performing a separate task. You control which tasks AUTOGEN performs by specifying a start phase and an end phase when you invoke AUTOGEN. For more information about the AUTOGEN phases, see Section 6.4.

You can add commands to the file SYS$SYSTEM:MODPARAMS.DAT to control the system parameter values and file sizes that AUTOGEN sets. AUTOGEN uses the information in this file to determine final values for system parameters or page, swap or dump file sizes. For more information, refer to the chapter about managing system parameters in the OpenVMS System Manager's Manual.

AUTOGEN can improve system performance by using dynamic information, called feedback, gathered from the running system.

Note

When making major configuration changes, do not use feedback. Specify nofeedback to assure the use of the initial AUTOGEN settings. See Table 6-4 for more information about nofeedback.
You control how AUTOGEN uses feedback by specifying an execution mode when you invoke AUTOGEN. To direct AUTOGEN to use feedback to make its calculations, run AUTOGEN in feedback mode. After a period of time, you can execute AUTOGEN in feedback mode to further refine system parameter settings. For more information about AUTOGEN feedback, refer to Section 6.3.

6.2 When to Run AUTOGEN

Compaq recommends that you run AUTOGEN in the following circumstances:

  • During a new installation or upgrade.
  • Whenever your work load changes significantly.
  • When you add an optional (layered) software product. Certain layered products might require you to execute AUTOGEN to adjust parameter values and page and swap file sizes. (For information about using AUTOGEN to modify page and swap files, refer to the chapter on managing page, swap, and dump files in the OpenVMS System Manager's Manual.) Refer to specific product documentation for installation requirements.
  • When you install images with the /SHARED attribute. The GBLSECTIONS and GBLPAGES parameters might need to be increased to accommodate additional use of global pages and global sections.
  • During normal operation, as part of a batch-oriented command procedure that runs AUTOGEN on a regular basis and automatically sends a report to an appropriate Mail account. The recommended procedure is described in the chapter on managing system parameters in the OpenVMS System Manager's Manual.

After a new operating system installation or upgrade, examine the results of calculations that AUTOGEN made to determine whether AUTOGEN has set system parameter values that are appropriate for your workload requirements.

Table 6-1 lists the system parameters affected by AUTOGEN calculations. AUTOGEN calculations also affect the size of page, swap and dump files. Table 6-2 lists the system parameters affected by AUTOGEN feedback.

Table 6-1 System Parameters Affected by AUTOGEN Calculations
ACP_DINDXCACHE ACP_DIRCACHE ACP_HDRCACHE
ACP_MAPCACHE ACP_MULTIPLE ACP_QUOCACHE
ACP_SWAPFLGS ACP_SYSACC BALSETCNT
BORROWLIM CTLPAGES DUMPSTYLE
ERLBUFFERPAGES 1 EXPECTED_VOTES FREEGOAL
FREELIM GBLPAGES GBLPAGFIL
GBLSECTIONS ++GH_EXEC_CODE ++GH_EXEC_DATA
++GH_RES_CODE ++GH_RES_DATA GROWLIM
+INTSTKPAGES LNMPHASHTBL 2 LNMSHASHTBL
LOAD_SYS_IMAGES 1 LOCKDIRWT LOCKIDTBL
LONGWAIT 1 MAXPROCESSCNT MINWSCNT
MMG_CTLFLAGS MPW_HILIMIT MPW_IOLIMIT 1
MPW_LOLIMIT MPW_LOWAITLIMIT MPW_THRESH 1
MPW_WAITLIMIT MPW_WRTCLUSTER MSCP_BUFFER
MSCP_LOAD MULTITHREAD MVTIMEOUT 1
NISCS_MAX_PKTSZ 1 NISCS_PORT_SERV NPAGEDYN
NPAGEVIR PAGEDYN PASTDGBUF
PFCDEFAULT PFRATH 1 PFRATL
++PHYSICAL_MEMORY +PHYSICALPAGES PIOPAGES
PIXSCAN PQL_DPGFLQUOTA 2 PQL_DWSDEFAULT
PQL_DWSEXTENT PQL_DWSQUOTA PQL_MPGFLQUOTA 2
PQL_MWSDEFAULT PQL_MWSEXTENT PQL_MWSQUOTA
PRCPOLINTERVAL 1 PROCSECTCNT QUANTUM 1
RECNXINTERVAL 1 RESHASHTBL RMS_DFMBC
RMS_DFMBFIDX RMS_DFMBFREL RMS_DFMBFSDK
RMS_DFMBFSMT RMS_DFMBFSUR RMS_DFNBC
SCSBUFFCNT SCSNODE SCSRESPCNT
SHADOW_MAX_COPY +SPTREQ SWPOUTPGCNT 2
SYSMWCNT TMSCP_LOAD VAXCLUSTER
+VBSS_ENABLE ++VCC_FLAGS ++VCC_MAXSIZE
VIRTUALPAGECNT VOTES WSDEC
WSINC 1 WSMAX ++ZERO_LIST_HI

+VAX specific parameter
++Alpha specific parameter
1Parameter affected only on Alpha systems
2Parameter affected only on VAX systems

6.3 Feedback

AUTOGEN feedback minimizes the necessity to modify parameter values or system file sizes. Feedback allows AUTOGEN to automatically size the operating system based on your actual work load. Sizing is the process of matching the allocation of system resources (memory and disk space) with the workload requirements of your site.

Feedback is information about how various resources are used by the system's work load. This information is continuously collected by the operating system executive. Because the system collects feedback when exception events occur, feedback collection does not affect system performance.

You control how AUTOGEN uses feedback by specifying an execution mode when you invoke AUTOGEN. When run in feedback mode, AUTOGEN analyzes this information and adjusts any related parameter values. For information about controlling AUTOGEN's use of feedback, see Section 6.5.

AUTOGEN collects feedback during the SAVPARAMS phase by executing the image SYS$SYSTEM:AGEN$FEEDBACK.EXE. AUTOGEN writes feedback information to the file SYS$SYSTEM:AGEN$FEEDBACK.DAT. This file is then read during the GETDATA phase. For more information about AUTOGEN phases, see Section 6.4.

Table 6-2 lists the system parameters affected by AUTOGEN feedback. Feedback also affects the size of page and swap files.

Table 6-2 System Parameters Affected by AUTOGEN Feedback
ACP_DINDXCACHE ACP_DIRCACHE ACP_EXTCACHE
ACP_FIDCACHE ACP_HDRCACHE ACP_MAPCACHE
ACP_QUOCACHE GBLPAGES GBLSECTIONS
++GH_EXEC_CODE ++GH_EXEC_DATA ++GH_RES_CODE
++GH_RES_DATA ++GH_RSRVPGCNT LNMSHASHTBL
LOCKIDTBL MAXPROCESSCNT MSCP_BUFFER
NPAGEDYN PAGEDYN RESHASHTBL
SCSBUFFCNT SCSCONNCNT SCSRESPCNT

++Alpha specific parameter

6.4 Phases

AUTOGEN executes in phases. You control which tasks AUTOGEN performs by specifying a start phase and an end phase when you invoke AUTOGEN. Table 6-3 lists the phases AUTOGEN can execute in order.

Table 6-3 AUTOGEN Phases
Phase Description
SAVPARAMS Saves dynamic feedback from the running system.
GETDATA Collects all data to be used in AUTOGEN calculations.
GENPARAMS Generates new system parameters; creates the installed image list.
TESTFILES Displays the system page, swap, and dump file sizes calculated by AUTOGEN (cannot be used as a start phase).
GENFILES Generates new system page, swap, and dump files if appropriate (cannot be used as a start phase).
SETPARAMS Runs SYSMAN to set the new system parameters in the default parameter file, saves the original parameters, and generates a new parameter file, AUTOGEN.PAR.
SHUTDOWN Prepares the system to await a manual reboot.
REBOOT Automatically shuts down and reboots the system.
HELP Displays help information to the screen.

The following sections describe each phase in detail.


Previous Next Contents Index