Parameters

hostspec
  • An IPv4 address, for example, 192.168.0.1
  • An IPv4 address with a subnet length, for example, 192.168.0.1/24
  • An IPv6 address, for example, FEC0::9:42:105:19
  • An IPv6 address with a prefix length, for example, FEC0::9:42:105:19/64
  • A host name that resolves to an IPv4 or IPv6 address. The host name can be specified with or without the DNS suffix. If specified without the suffix, the suffix is assumed to be one of the suffixes defined to resolver for the host where syslogd is running.
facility
See Supported facility names for syslogd for details.
priority
See Priority codes for details.
destination
See Supported destinations for syslogd for details.
-F
When the destination is a UNIX file, this parameter specifies the access permissions (modes) for the file if the file must be created dynamically. See the description of the /file destination in File destinations for syslogd for details.
-D
When the destination is a UNIX file, this parameter specifies the access permissions (modes) for the directory part of the file name if the directory (or directories) containing the file must be created dynamically. See the description of the /file destination in File destinations for syslogd for details.
-N
When the destination is a UNIX file, this parameter specifies a unique qualifier to append to the archive data set prefix specified on the previous instance of the BeginArchiveParms statement. The contents of the existing UNIX file are archived by copying them into the specified archive dataset. The existing UNIX file is re-initialized and ready to receive more messages. See the description of the /file destination in File destinations for syslogd for details.

Result: The re-initialization of the destination log file causes a new file with the same name to be created as part of the archive process. Ensure that the desired permission bits and file ownership attributes are set as described in Setting permissions for log files and directories in z/OS Communications Server: IP Configuration Guide.

-X
When the destination is a UNIX file, this parameter specifies that the contents of the z/OS UNIX file should be discarded instead of archived when an archive event occurs. The existing UNIX file is re-initialized and ready to receive more messages. The original contents of the file are lost. Even though the -X parameter does not cause the contents of a file to be archived, the file is still governed by archive events. See the description of the /file destination in File destinations for syslogd for details.

Result: The re-initialization of the destination log file causes a new file with the same name to be created as part of the archive process. Ensure that the desired permission bits and file ownership attributes are set as described in Setting permissions for log files and directories in z/OS Communications Server: IP Configuration Guide.

Restrictions:
  • The -F, -D, -N, and -X parameters are only valid when the destination is a z/OS UNIX file system file.
  • Start of changeThe -F, -D, -N, and -X parameters are only valid when syslogd is started with the -c option.End of change
  • You cannot specify scope information as part of an IP address or a host name.
  • You cannot specify the -F or -D parameter with the -N or -X parameter.
  • You cannot specify the -N parameter with the -X parameter.

The \t parameter in the syntax diagram is a tab character; the \b parameter is a blank space.