.*-----------------------------------------------------------------------**
.*
.*  Compile options:
.*
.*    CrtPnlGrp PnlGrp( SEC107H )
.*              SrcFile( QPNLSRC )
.*              SrcMbr( SEC107H )
.*
.*-----------------------------------------------------------------------**
:PNLGRP.

:HELP NAME='PRTSSLTRC'.
Print SSL Trace Data - Help
:P.
The Print SSL Trace Data (PRTSSLTRC) command will process and format the
Trace Internal (TRCINT) command's output file for a trace of type
Secure Sockets Layer (SSL) APIs (TRCTYPE *SCKSSL).
:P.
The following command will initiate a trace of the required type:
:P.
:XMP.
TRCINT SET(*ON)
       TRCTBL('SSL-1700x')
       SIZE(512 *MB)
       TRCTYPE(*SCKSSL)
       SLTTRCPNT((17000 17009))
:EXMP.
:P.
Following the above trace initiation and allowing time for SSL activity
to be performed, a valid trace output file will be produced by running
the following command:
:P.
:XMP.
TRCINT SET(*OFF)
       TRCTBL('SSL-1700x')
       OUTPUT(*OUTFILE)
       OUTFILE(QGPL/SSL1700X)
       OUTMBR(*FIRST *REPLACE)
:EXMP.
:P.
The above command will produce a trace output file by the name of
SSL1700X in library QGPL. The qualified name of this file should
be submitted as the primary parameter for this command.
:P.
To clean up the above trace and release the associated resources, run
the following command:
:P.
:XMP.
TRCINT SET(*END)
       TRCTBL('SSL-1700x')
:EXMP.
:P.
Note that the above command will not delete the trace output file. The
responsibility for this effort remains with you, at the point where you no
longer require to process or retain the trace output file.
:P.
For more information please refer to:
:P.
:HP2.SSL Concepts 7.2:EHP2.
http://www-01.ibm.com/support/knowledgecenter/ssw_ibm_i_72/rzain/rzainconcepts.htm
:P.
:HP2.SSL Concepts 7.1:EHP2.
http://www-01.ibm.com/support/knowledgecenter/ssw_ibm_i_71/rzain/rzainconcepts.htm
:P.
:HP2.Restrictions::EHP2.
:UL.
:LI.
You must have *SERVICE special authority to run this command.
:EUL.
:EHELP.

:HELP NAME='PRTSSLTRC/FILE'.
Trace file (FILE) - Help

:XH3.Trace file (FILE)
:P.
Specifies the name of the Trace Internal (TRCINT) command's output file
to process.
:P.
In order for this command to process the file correctly, the specified
file must be a physical data file and have a record format name of
QSCTRCIN.
:P.
This is a required parameter.
:P.
:HP2.Qualifier 1: Trace file:EHP2.
:PARML.
:PT.:PV.name:EPV.
:PD.
Specify the name of the trace output file to process.
:EPARML.
:P.
:HP2.Qualifier 2: Library:EHP2.
:PARML.
:PT.:PK DEF.*LIBL:EPK.
:PD.
All libraries in the library list for the current thread are
searched until the first match is found.
:PT.:PK.*CURLIB:EPK.
:PD.
The current library for the thread is used to locate the file.  If
no library is specified as the current library for the job, the QGPL
library is used.
:PT.:PV.name:EPV.
:PD.
Specify the name of the library to be searched.
:EPARML.
:EHELP.

:HELP NAME='PRTSSLTRC/PERIOD'.
Time period for trace output (PERIOD) - Help

:XH3.Time period for trace output (PERIOD)
:P.
Specifies the period of time for which the logged trace data is shown.
This parameter contains two element lists of two elements each.  A value
or *N must be specified for an element if a subsequent element value
will be specified in order to maintain its position in the parameter
value sequence.  If :HP2.PERIOD:EHP2. is not specified, the following
values are assumed:
:P.
:XMP.
PERIOD((*AVAIL *CURRENT) (*AVAIL *CURRENT))
:EXMP.
:P.
:HP2.Element 1: Start time and date:EHP2.
:PARML.
:PT.:PD.
:HP2.Element 1: Beginning time:EHP2.
:P.
One of the following is used to specify the starting time at which
or after which the trace data must have been logged.  Any entries
logged before the specified time and date are not shown.
:PARML.
:PT.:PK DEF.*AVAIL:EPK.
:PD.
Any logged trace data that is available for the specified starting
date is shown.
:PT.:PV.time:EPV.
:PD.
Specify the starting time for the specified starting date that
indicates the logged trace data to be shown.  The time is specified
in 24-hour format and can be specified with or without a time
separator.
:EPARML.
:PT.:PD.
:HP2.Element 2: Beginning date:EHP2.
:PARML.
:P.
One of the following is used to specify the starting date on which
or after which the trace data must have been logged.  Any entries
logged before the specified date are not shown.
:PT.:PK DEF.*CURRENT:EPK.
:PD.
The logged trace data for the current day and between the specified
starting and ending times (if specified) is shown.
:PT.:PK.*BEGIN:EPK.
:PD.
The logged trace data from the beginning of the log is shown.
:PT.:PV.date:EPV.
:PD.
Specify the starting date with or without date separators.  The date
must be entered in the date format that this job uses, as specified
in the date format job attribute.  If date separators are used then
they need to be the same as the date separator that this job uses,
as specified in the date separator job attribute.
:EPARML.
:EPARML.
:P.
:HP2.Element 2: End time and date:EHP2.
:PARML.
:PT.:PD.
:HP2.Element 1: Ending time:EHP2.
:P.
One of the following is used to specify the ending time before which
the trace data must have been logged.
:PARML.
:PT.:PK DEF.*AVAIL:EPK.
:PD.
Any logged trace data that is available for the specified ending date
is shown.
:PT.:PV.time:EPV.
:PD.
Specify the ending time for the specified ending date that
determines the logged trace data to be printed.
:PT.:PD.
:HP2.Element 2: Ending date:EHP2.
:P.
One of the following is used to specify the ending date before which
or on which the trace data must have been logged.
:PARML.
:PT.:PK.*CURRENT:EPK.
:PD.
The current day is the last day for which logged trace data is shown.
:PT.:PK DEF.*END:EPK.
:PD.
The last day on which trace data was logged is the last day for which
the logged data is shown.  If :HP2.PERIOD(*END):EHP2. is specified,
an ending time value other than *AVAIL for end-time is ignored.
:PT.:PV.date:EPV.
:PD.
Specify the ending date with or without date separators.  The
date must be entered in the date format that this job uses, as
specified in the date format job attribute.  If date separators
are used then they need to be the same as the date separator
that this job uses, as specified in the date separator job
attribute.
:EPARML.
:EPARML.
:EPARML.
:EHELP.

:HELP NAME='PRTSSLTRC/VERSION'.
Protocol version (VERSION) - Help

:XH3.Protocol version (VERSION)
:P.
Specifies SSL protocol version(s) to apply as a selection criterion
when processing the trace data records.
:P.
:HP2.Single values:EHP2.
:PARML.
:PT.:PK DEF.*ALL:EPK.
:PD.
All SSL protocol versions are selected when processing the the trace
data records.
:EPARML.
:P.
:HP2.Other values (up to 5 repetitions):EHP2.
:PARML.
:PT.:PK.*TLSV1.2:EPK.
:PD.
Trace data records identifying the TLSv1.2 SSL protocol version are
included in the printed trace data report.
:PT.:PK.*TLSV1.1:EPK.
:PD.
Trace data records identifying the TLSv1.1 SSL protocol version are
included in the printed trace data report.
:PT.:PK.*TLSV1.0:EPK.
:PD.
Trace data records identifying the TLSv1.0 SSL protocol version are
included in the printed trace data report.
:PT.:PK.*SSLV3:EPK.
:PD.
Trace data records identifying the SSLv3 SSL protocol version are
included in the printed trace data report.
:PT.:PK.*SSLV2:EPK.
:PD.
Trace data records identifying the SSLv2 SSL protocol version are
included in the printed trace data report.
:EPARML.
:EHELP.

:HELP NAME='PRTSSLTRC/INCLUDE'.
Include (INCLUDE) - Help

:XH3.Include (INCLUDE)
:P.
Specifies selection criteria that can be applied in order to narrow
the resulting trace data report.
:P.
:HP2.Element 1: Cipher suite:EHP2.
:P.
Specifies a full or partial cipher suite identifier to be used as a
selection criterion when producing the trace data report.
:P.
The following is an example of the format and appearance of a full
cipher suite identifier:
:P.
:XMP.
TLS_RSA_WITH_AES_128_CBC_SHA
:EXMP.
:PARML.
:PT.:PK DEF.*ALL:EPK.
:PD.
All cipher suite identifiers are included in the trace data report.
:PT.:PV.character-value:EPV.
:PD.
Specify a full or partial cipher suite identifier to be used as a
selection criterion.
:EPARML.
:P.
:HP2.Element 2: IP address:EHP2.
:P.
Specifies a full or partial IPv4 or IPv6 IP address fier to be used as
a selection criterion when producing the trace data report.
:P.
The specified IP address is matched against both the local and the
remote IP address in the SSL trace record.
:P.
:PARML.
:PT.:PK DEF.*ALL:EPK.
:PD.
All IP addresses are included in the trace data report.
:PT.:PV.character-value:EPV.
:PD.
Specify a full or partial IP address to be used as a selection
criterion against the local and remote IP address.
:EPARML.
:EHELP.

:HELP NAME='PRTSSLTRC/OUTQ'.
Output queue (OUTQ) - Help

:XH3.Output queue (OUTQ)
:P.
Specifies the qualified name of the output queue used for the printed
trace data report generated by this command.
:P.
:HP2.Single values:EHP2.
:PARML.
:PT.:PK DEF.*JOB:EPK.
:PD.
The output queue used by the job that is currently running is used for
the trace data report.
:EPARML.
:P.
:HP2.Qualifier 1: Output queue:EHP2.
:PARML.
:PT.:PV.name:EPV.
:PD.
Specify the name of the output queue to be used for the trace data
report.
:EPARML.
:P.
:HP2.Qualifier 2: Library:EHP2.
:PARML.
:PT.:PK DEF.*LIBL:EPK.
:PD.
All libraries in the jobs library list are searched.
:PT.:PK.*CURLIB:EPK.
:PD.
The current library is searched. If no current library is found
library QGPL is used.
:PT.:PV.name:EPV.
:PD.
Specify the library where the output queue is located.
:EPARML.
:EHELP.

:HELP NAME='PRTSSLTRC/COMMAND/EXAMPLES'.
Examples for PRTSSLTRC - Help

:XH3.Examples for PRTSSLTRC
:P.
:HP2.Example 1: Printing all trace records for the current date:EHP2.
:XMP.
PRTSSLTRC FILE(SSL1700X)
:EXMP.
:P.
This command processes and prints all SSL trace records in the
SSL1700X trace output file located in the job's library list and
which were logged on the current date.
:P.
:HP2.Example 2: More Complex Command Example:EHP2.
:XMP.
PRTSSLTRC FILE(QGPL/SSL1700X)
          PERIOD((*AVAIL 31052015) (*AVAIL 20062015))
          VERSION(*TLSV1.0 *TLSV1.1)
:EXMP.
:P.
This command processes and prints the SSL trace records in the
SSL1700X trace output file in library QGPL for the period
beginning May 31, 2015 and ending on June 20, 2015. Only trace
records associated with the SSL protocol version TLSv1.0 or TLSv1.1
are included in the printed trace report.
:EHELP.

:EPNLGRP.
