Editing the system configuration definition for Infoprint Central

The system configuration definition in the Printer Inventory contains attributes that let you customize Infoprint Server while Infoprint Server is running. If dynamic configuration is enabled, you can specify these attributes in the system configuration definition to customize Infoprint Central:

console-name = name

The name of the extended MCS console that Infoprint Central uses to send commands to the z/OS® system.

Rules:

1. The console name must be 2 – 8 alphanumeric or national (#, $, and @) characters. The first character cannot be numeric. Enclose a name that contains national characters in single or double quotation marks.
2. Do not use these reserved names: HC, INSTREAM, INTERNAL, OPERLOG, SYSIOSRS, SYSLOG, UNKNOWN.
3. If you specify the Infoprint Central daemon (aopssid) in the start-daemons attribute, this console name must be unique among all active and inactive console names on all systems in a sysplex. To display the active and inactive console names, enter this MVS™ command:

   DISPLAY EMCS,ST=L

   For information about the DISPLAY EMCS command, see z/OS MVS System Commands.
4. If dynamic configuration is enabled, specify this attribute in the system configuration definition. If you change this attribute while the Infoprint Central daemon (aopssid) is running, stop aopssid and restart Infoprint Server.
5. If dynamic configuration is not enabled, specify this attribute in the aopd.conf file. If you change this attribute while Infoprint Server is running, stop all Infoprint Server daemons and restart Infoprint Server. Be sure to wait for all daemons to stop before you restart Infoprint Server.

Default: The Printer Inventory name (specified in the inventory attribute), followed by the last 4 characters of the system name. If the Printer Inventory name is AOP1 and the system name is MYSYS1, the default console name is AOP1SYS1.

Example: console-name = PRINTCON

log-retention = days

The number of days worth of messages that Infoprint Central displays for print jobs and printers. Also, the number of days for which Infoprint Central displays print jobs that are removed from the JES spool.

If you do not use the MVS system logger for the common message log, this attribute also determines how many days worth of messages Infoprint Server retains in the z/OS UNIX file system. If you use the system logger for messages, the retention period that is specified in the system logger log stream definition is used instead.

You can specify a value 0 - 59. A value of 0 means that Infoprint Central cannot display any messages and cannot display information about print jobs are removed from the JES spool. In addition, if you do not use the system logger for messages, Infoprint Server does not write any messages in the z/OS UNIX file system.

Guidelines:

1. If you do not use the system logger for messages, specify a value greater than 0 or use the default of 1 day, so that Infoprint Server writes messages in a z/OS UNIX file system.
2. If you use the system logger for messages and also use Infoprint Central, the value needs to be less than or equal to the retention period specified in the log stream definition. If you specify a higher value than the retention period for the log stream, you might not be able to see the messages for all the historical print jobs that Infoprint Central displays.
3. If you use the system logger but do not use Infoprint Central, you can specify 0 to save space in the z/OS UNIX file system.
4. If you specify a value greater than 0 or use the default of 1 day, you might need to increase the amount of space available to the file system mounted at the /var or /var/Printsrv mount point because the common message log and Historical Inventory can contain a large amount of data. See Calculating DASD space requirements for the /var/Printsrv directory.
5. Because the common message log and Historical Inventory can contain a large amount of data, start with a value of 1 day. Increase the value by 1 day if there is enough space in the file system and if users request to see more messages or historical information.
6. If the size of the common message log in the z/OS UNIX file system grows too large, you can decrease its size. For more information, see Reducing the size of the common message log in the z/OS UNIX file system.
7. If you use aoplogu to view messages, the date and time format that is displayed in messages is controlled by the TZ and either the LC_TIME or LC_ALL environment variables. See Setting environment variables for the Printer Inventory Manager.

   If you use Infoprint Central to view messages, the date and time format for the messages is controlled by the operating system that runs your web browser.

   

Rules:

1. If dynamic configuration is enabled, specify this attribute in the system configuration definition. If you change this attribute, you do not need to restart Infoprint Server.
2. If dynamic configuration is not enabled, specify this attribute in the aopd.conf file. If you change this attribute while Infoprint Server is running, stop all Infoprint Server daemons and restart Infoprint Server. Be sure to wait for all daemons to stop before you restart Infoprint Server.

Default: log-retention = 1

Example: log-retention = 3

This screen shows a portion of the ISPF panel that you use to edit the system configuration definition for Infoprint Central:

                          Infoprint Server: System Configuration                
                                                                        
 Messages:                                                                   
    Log retention period (days)  . . . . . . . 1                             

 Infoprint Central:                                                             
    Extended MCS console name . . AOP1xxxx