Sample scenario that uses the redirect_server_output_dir environment variable

WebSphere® Application Server for z/OS® SYSOUT and SYSPRINT logs can also be redirected to z/OS UNIX files and rolled by using the WebSphere environment variable redirect_server_output_dir.

A new set of files for SYSOUT and SYSPRINT is created for each server region at the following times:
  • Each time that the server job is restarted.
  • Each time that the modify command is issued with the ROLL_LOGS parameter.

The new files are created in the directory that is specified by the redirect_server_output_dir environment variable.

The following file naming conventions are used for the redirected files:
cellName.nodeName.serverName.jobName.jobId.asType.date.time.SYSOUT.txt
cellName.nodeName.serverName.jobName.jobId.asType.date.time.SYSPRINT.txt

For each server region, the cell name, node name, server name, job name, and address space type are constant. Only the job ID, date, and time are variable.

To convert one of these file naming convention into a file path pattern for Z Common Data Provider configuration, complete the following steps:
  1. Add the absolute path, which is specified in the WebSphere environment variable redirect_server_output_dir, to the beginning of the file path pattern.
  2. Replace cellName, nodeName, serverName, and jobName with the appropriate values.
  3. Replace asType with CTL (for controller), SR (for servant), or CRA (for adjunct).
  4. If you are using JES2, replace jobId with ????????, which matches any eight characters.

    If you are using JES3, replace jobId with *, which matches any sequence of characters. In JES3, jobId is sometimes incorrectly populated with the job name rather than the job ID.

  5. Replace date with ??????, which matches any six characters.
  6. Replace time with ??????, which matches any six characters.

File path pattern for this scenario

The following file path pattern is an example of the pattern to use for SYSPRINT files for the BBOSAPP server that is using JES2:
/u/myLogDir/BBOCELL.BBONODE.BBOSAPP.BBOSAPPS.????????.SR.??????.??????.SYSPRINT.txt