IBM HS64, HOTS, HOTR User Manual

z/TPF HOTX Driver

(HOTR/HOTS/HS64)

User's Guide

Last Updated 6/5/2006

This page intentionally left blank.

2 HOTX Driver User's Guide © Copyright IBM Corp. 2006

ZTEST HOTX

ZTEST HOTR/HOTS/HS64

The HOTX driver suite contains the HOTR, HOTS and HS64 drivers. The HOTR driver tests the TPF DASD supports by creating a 'hot record' (default using #HOTREC) to blast channels and test cache. The instances created by the HOTR driver stresses the DASD system by repeatedly finding and filing the ‘hot record’. The first time it runs, it allocates a 4K frame on the system heap for the subsystem to store the information (8 bytes for each entry containing the flags (run, stat, stop, ebrout) of all ordinals (0x00-0x13) of all I-stream (up to 24).

In the scope of HOTR driver, the instances of the HOTR (i.e. ECBs of QHT1), created by the START parameter, read in the request from the status table and run accordingly. These ECBs will keep running, accessing a 4 byte field in its ordinal of the target file/record, checking whether the number in the field matches the number saved in the instances. They will increment the number on both fields, file the record and start over again until they are requested to exit (STOP parameter). The statistics information can be requested by the STAT parameter. The parameters (START, STAT, STOP) compose the actions of the HOTR driver.

The target record stores the access information about the target record for all the I-Streams (maximum 24) of all the processors (maximum 32). The access information is a 4 byte long integer count number which is incremented and updated by the QHT1s every time they access the files.

The HOTS driver tests the VFA bit version of the HOTS driver. Both drivers set up the request in the status table on the system heap for a specific ordinal. The QHT1s will enter the snippet segment (QHT3) if the HOTS (QHT2) sets the flag (snippets, nosnippets, normal, state#, service#, fct mode etc.) in the fields assigned to them in the status table. In the scope of QHT3, snippet is set up, the FARW is ported from D8 to D7 and D6 (only 2 states need 2), the FLFAC that each state needs is done and the find and hold record are done if the State/Service (detail in Appendix B) pairing needs a hold. The SET SNIPPETS parameter runs all the combinations of the State/Service starting from State 1/Service 1, 2, 3, ... pairs to State 14/ Service ..., 35, 36 then start over again.

synchronization across the L/C system. The HS64 is the 64

Requirements and restrictions

None.

HOTR Format

.-Ordinal-0-. >>--ZTEST--+-----+- --HOTR- -+-STARt-+- -+---------+- -+-----------+-+--->< '- -i-' +-STAT--+ +-FIleadd-+ +-Ordinal-n-+ | +-STOp--+ '-FAcid---' '-All-------' | '-Help----------------------------------'

indicates the specific I-stream in which the driver will be run. If i is not specified, the test case(s) will be executed on the I-stream on which the command is entered.

STARt

starts the driver on the ordinal number specified.

Last Updated 6/5/2006

STOp

stops the driver on the ordinal number specified.

STAT

queries the status of the ordinal number specified.

FIleadd

uses the address specified as the address of the ‘hot record’.

Note: The FILEADDR parameter overrides the FACID parameter.

FAcid

uses the FACE ID specified as the FACE ID of the ‘hot record’.

Ordinal

specifies number in Hex 0x00-0x13. If not specified, the default is 0.

All

runs the action with all 20 ordinals 0x00-0x13.

Note: The ALL parameter overrides the ORDINAL parameter.

Help

displays the correct syntax of the command.

Examples

The following example will start HOTR with all ordinals on I-stream two:

ZTEST 2 HOTR START ALL

The following example will start HOTR with ordinal 0 on I-stream one:

ZTEST HOTR START

The following example will query the status of HOTR with ordinal 0 on I-stream one:

ZTEST HOTR STAT

The following example will query the status of HOTR with all ordinals on I-stream three:

ZTEST HOTR STAT ALL

The following example will stop HOTR with ordinal 0 on I-stream one:

ZTEST HOTR STOP

The following example will stop HOTR with all ordinals on I-stream four:

ZTEST 4 HOTR STOP ALL

+ 9 hidden pages