Specifications
138 IBM System z Personal Development Tool: Volume 3 Additional Topics
#------------- 1090 instance 1 ---------------------------
[system]
processors 1
...
[adjunct-processors]
domain 0 1
domain 1 1
domain 2 1
#------------- 1090 instance 2 ---------------------------
[system]
processors 1
...
[adjunct-processors]
domain 0 2 #All the domain statements
domain 1 2 #could be in the controller
domain 2 2 #devmap instead. Your choice.
#------------- 1090 instance 3 ---------------------------
[system]
processors 1
...
[adjunct-processors]
domain 0 3 #If the domain statements are in the
domain 1 3 #controller devmap, they need the relevant
domain 2 3 #member name as the first parameter.
Notice that each 1090 instance has a different domain number specified in the domain
statements. In this example the domain numbers are the same as the instance numbers, but
this is just a coincidence.
13.4.2 Coprocessor control commands
A number of commands are included for specialized management of the cryptographic
coprocessors. These commands are issued from a Linux terminal window. zPDT must be
operational for these commands to be used. They are not needed for normal system usage
and we suggest you do not experiment with them unless you have a fairly good understanding
of what you are doing. In the following commands the n variable is the cryptographic
coprocessor number and the y variable is a domain number. Briefly, the commands are:
$ ap_zeroize -a n -d y
$ ap_zeroize -a n -i
This command reinitializes (zeros) all the data, such as keys, that is retained by the
coprocessor. In the syntax shown here, n is a crypto adapter number and y is a domain
name. The first version of the command affects only the specified domain. The second
version (with the -i operand) zeros the whole adapter. Either -i or -d y must be
specified (with an appropriate domain number for y).
$ ap_query
$ ap_query -a n
This command queries basic status and domain information. With no operand it lists
the coprocessors available to the System z. With an operand, it lists which domains are
used by the indicated coprocessor.