The TRANSFER control statement is used to transfer usage priced products from one processor to another. The processor the products are transferred to must be a processor where no usage priced products currently execute. Sample TRANSFER control statements can be found in example 6 under Usage pricing examples.

Syntax

[TRANSFER((old_type,old_model,old_serial_number),
               (new_type,new_model,new_serial_number))]  

TRANSFER

This is an optional statement. TRANSFER specifies that the processor identified by (old_type,old_model, old_serial_number) has been replaced by the processor identified by (new_type,new_model, new_serial_number).

Specify this statement if one processor is being replaced by another and all the usage products on the existing system are being transferred to the new processor. The new processor cannot already have products that are billed by usage. Specifying this statement causes the product usage data for products running on the two processors specified to be reported in the same Software Usage Report.

Note:

1. TRANSFER affects only stand-alone processors. It does not have any affect on processors that are part of a parallel sysplex.
2. The TRANSFER statement must not precede any PROCESSOR statement referring to TRANSFER's old_type,old_model,old_serial_number. The TRANSFER statement does not require that such a PROCESSOR statement be present, if that PROCESSOR statement was provided in a previous execution of IFAURP.
3. The usage report program only supports the one time transfer of a processor.

old_type

One of a list of numbers (old_type, old_model, and old_serial) that identify the processor that is being replaced. Value is 1-4 characters in length and consists of only numeric and national characters.

old_model

One of a list of numbers (old_type, old_model, and old_serial) that identify the processor that is being replaced. Value is 1-8 characters in length and consists of any character.

old_serial_number

One of a list of numbers (old_type, old_model, and old_serial) that identify the processor that is being replaced. This value is 5 characters in length for the US and 7 characters in length for Europe, Middle East, Africa (EMEA); Canada; and Latin America. It consists of only decimal digits. For example, 20012 (US), 1120012 (EMEA and Latin America).

new_type

One of a list of numbers (old_type, old_model, and old_serial) that identify the processor that is being replaced. Value is 1-4 characters in length and consists of only numeric and national characters.

new_model

Value is 1-8 characters in length and consists of any character.

new_serial_number

The serial number consists of only decimal digits. It is the last 5 characters of the 6 character processor serial number for all IBM® geographies, except EMEA and Latin America where a two character plant of manufacture precedes the 5 character serial number. For example, 11263 (US) and 0211263 (EMEA and LA).

Note:

1. A list of the currently supported non-IBM processors is listed in Type-model values for IBM and non-IBM processors. Only the type and model values listed in this table will be accepted as valid non-IBM values. If you specify an unsupported processor value as part of a TRANSFER, IFAURP will not produce a valid Software Usage Report.
2. Performance monitors like RMF™ do not return the true processor serial when the processor is running PR/SM™. When running PR/SM, the second character of the 6 character processor serial number has been overlaid with the LPAR number.
3. It is not necessary to specify the TRANSFER control statement for processors with the same TYPE and SERIAL values. When IFAURP detects processors with the same TYPE and SERIAL values, TRANSFER is automatic.

IBM usage pricing note: The customer must supply the processor serial numbers on these control statements that agree with the processor serial numbers registered with IBM for participation in usage pricing.