aoplogu command

Format

Description

The aoplogu command lets Infoprint Server administrators view messages in the common message log. You can specify that you want to view:

• All the messages.
• The messages in a range of times. For example, the messages from 6 September 2013 to 10 September 2013, or the messages beginning on 6 September 2013.
• The most recent messages for a length of time. For example, the messages for the last day or for the last two minutes.

The messages are written to standard output (stdout).

The aoplogu command can read messages that were written in a z/OS® UNIX file system (by default, the /var/Printsrv file system) or in an MVS™ system logger log stream.

Options

-b time

The beginning time of the range of messages that you want to view. The default is the oldest message that is available in the common message log.

-e time

The ending time of the range of messages that you want to view. The default is the most recent message that is available in the common message log.

-l time

The most recent messages for the length of time that you specify.

-n log-stream

The name of a log stream defined to the MVS system logger for the Infoprint Server common message log. Specify this option only if your installation has defined a log stream and Infoprint Server is not running. If Infoprint Server is running, the aoplogu command can automatically determine the name of the log stream.

If you specify this option, the aoplogu command reads messages only from the specified log stream. It does not read any messages that were written in the z/OS UNIX file system or in any other log streams.

The format of time is one of these:

year:month:day:hour:minute
month:day:hour:minute
day:hour:minute
hour:minute
minute

Usage notes

1. To use the aoplogu command, you must be defined to RACF® as a z/OS UNIX user and be connected to the RACF AOPADMIN group. For more information, see z/OS Infoprint Server Customization.
2. If your installation uses the MVS system logger for the Infoprint Server common message log, you must also have READ access to the resource profile for the log stream in the RACF LOGSTRM class. For more information, see z/OS Infoprint Server Customization.
3. When you specify the -b or -e option, the defaults for the year, month, day, and hour are the current year, month, day, and hour.
4. When you specify the -b or -e option, you can enter 2-4 digits for the year. For example, 13, and 2013 all mean the year 2013.
5. You can enter any value for the units of time, beginning with 0. For example, you can enter 25 for the hour or 61 for the minute.
6. The time is inclusive. For example, aoplogu -b 0 -e 0 includes all messages that occurred in the first minute of the current hour.

Examples

1. To view all the messages:

   aoplogu

2. To view all the messages from 6 September 2013 to 10 September 2013:

   aoplogu -b 2013:09:06:0:0 –e 2013:09:10:0:0

3. To view all the messages for the last day:

   aoplogu -l 1:0:0

4. To view all the messages for the last two minutes:

   aoplogu -l 2

5. To view all the messages for the last day plus the last three hours and to put them in a file called mymessages:

   aoplogu -l 1:3:0 > mymessages

Environment variables

AOPCONF

Names the Infoprint Server configuration file. The file named in this variable takes precedence over configuration file /etc/Printsrv/aopd.conf.

LANG

The language used for messages.

LC_ALL

The locale used to format date and time information in common log messages.

LC_TIME

The locale used to format date and time information in common log messages.

LIBPATH

The path used to locate dynamic link libraries (DLL).

NLSPATH

The directory where the Infoprint Server message catalogs are located.

TZ

The time zone displayed in common log messages.

Files

/etc/Printsrv/aopd.conf

The default Infoprint Server configuration file.The file named in the AOPCONF environment variable takes precedence over this file.

Exit values

0

Successful completion.

>0

An error prevented the messages from being displayed.