Appendix B: Performance Agent Logical Names

Performance Agent logical names begin with the prefix PSDC$. This appendix lists those names and describes how they are used to control various aspects of the Performance Agent module.

PSDC$DATABASE

A system logical name defined by PSDC$STARTUP.COM if not previously defined. The database area may contain:

Item	Logical Name
Data collection error log	PSDC$DC.LOG
Holidays file	PSDC$HOLIDAYS.TXT
History files	PSDC$nodename_dd-mmm-yyyy_dd-mmm-yyyy.name
History journal files	PSDC$nodename_dd-mmm-yyyy_dd-mmm-yyyy.name_JOU
Daily data files	PSDC$nodename_yyymmmdd.coll-def-name
Parameters file	PSDC$PARAMS.DAT
Schedule file	PSDC$SCHEDULE.DAT

PSDC$EXAMPLES

A system logical name defined by PSDC$STARTUP.COM if not previously defined. This area may contain:

Item	Logical Name
Template command procedure to generate daily reports	PSDC$DAILY.COM
Template command procedure to archive data daily	PSDC$ARCHIVE.COM)
DECwindows setup file	PSDC$RESOURCES

PSDC$hscname_hscunitnumber

The argument is two numbers separated by an underscore (for example, 7_3), which assigns the requestor and port numbers to a shadow set member. This logical provides channel assignments for shadow set members (disks) that are not captured by default. Non-shadow set disks have their channel assignments collected correctly without the need for a logical name; to set up logical names see the procedure following these bullets.

PSDC$NODE

A system logical name of up to six characters like a DECnet node name. It is defined by PSDC$STARTUP.COM if the system is not a member of a cluster system and if it has not previously been defined.

PSDC$IO_PACKET_MAX

This logical name can be used when it is a good idea to preordain the use of non-paged pool; this logical name will bound the amount available to PSDC for I/O and event buffer flushing.

The argument is an integer that specifies the maximum number of non-paged pool allocations, where each allocation is 2008 bytes, for buffering OpenVMS I/O event records. Normally a non-paged pool allocation occurs whenever the system wide device I/O rate causes a deficiency in the number of these buffers available.

PSDC$SPMTIMER

When this logical name is defined and set to 0, extended CPU statistics are not collected. When set to 1, these statistics are collected. If this logical is not defined, all statistics are collected by default.

PSDC$PAGE_FILE_QUOTA

Increase the amount of Page File Quota available to the Performance Agent image.

To set up the logical names

Enter the SHOW DEVICE command for a shadow set disk:

Device              Device          Error   Volume         Free  Trans Mnt
Name                Status          Count    Label        Blocks Count Cnt 
$2$DUA0:   (ERNEST) ShadowSetMember     0 (member of $2$DUS111:)
$2$DUA16:  (ERNEST) ShadowSetMember     0 (member of $2$DUS111:)
$2$DUS111: (ERNEST) Mounted             0 COGNAC          131362   408   3

On the HSC serving the shadow set (ERNEST), enter the SHOW DISKS command:

Unit    Req   Port   Type   State                   Version
0     6      2    RA82   Online, HostAccess      MC - 33, HV - 2 
Member of Shadow Unit 111 
16    6      3    RA82   Online, HostAccess      MC - 33, HV - 2 
Member of Shadow Unit 111 
111 (virtual)     RA82   Online, HostAccess      Member Count: 2

Form the logical name from the HSC nodename and the unit number and the equivalence string from the “req” and “port” columns:
```
$ DEFINE/SYSTEM/EXECUTIVE_MODE PSDC$ERNEST_0 "6_2"
$ DEFINE/SYSTEM/EXECUTIVE_MODE PSDC$ERNEST_16 "6_3"
```
These might be added to PSDC$STARTUP.COM; however, a reinstallation of Performance Management might purge this file.
Restart the Performance Agent to load the mapping information from the new logical names.
Optionally verify the correct collection with the command ADVISE COLLECT REPORT=DUMP_DISKS.
If the channel assignments are not captured by default and you do not use this scheme to assign HSC channel information to shadow set disks, PSDC will not detect HSC channel bottlenecks for shadow sets, nor will graphs of channel data be available for shadow set I/Os, nor will a model configuration of the disk channels be correct.