This section lists the messages that Acquire for z/VM may produce along with the return codes associated with any problems.
AVM000I Precisely INC.
FOR SUPPORT WITH ANY ASPECT OF SYNCSORT CAPACITY MANAGEMENT
--------:--------------------------------------------:
: Portal : https://mysupport.syncsort.com :
: eMail : support@precisely.com :
: Phone : +1-877-4athene or +44(0)1823 259231 :
: Web : www.precisely.com :
-----------------------------------------------------Meaning: Standard ownership and support detail display
Module: AVMMAIN
AVM001I INPUT PARAMETERS FOLLOW
>(parameter card1)
>(parameter card2)
...etc
AVM002I END OF INPUT PARAMETERS Meaning: Echo of input parameters provided by user
Module: AVMPPRM
AVM003I -- PARAMETERS IN EFFECT --
Parameter1=Value
Parameter2=Value
... etc
AVM004I -- END OF PARAMETERS IN EFFECT -- Meaning: Print of all parameters in effect for this run
Module: AVMPPRM
AVM005E (error)
Meaning: A parameter card has failed validation. The error text can be:
BOTH VMONDATA AND VELXXX INPUT FILES DETECTED
CPU COUNT MUST FROM 1 TO 96
DUPLICATE USER - XXXXXXXX
DUPLICATE WORKLOAD - XXXXXXXX
ERROR - END DATE/TIME MUST BE GREATER THAN START DATE/TIME
ERROR – START|END TIME WITHOUT A DATE IS NOT VALID
INVALID xxxxxxxx PARAMETER: VALID VALUES ARE Y OR N
INVALID COMBINATION: USSONLY=Y BUT NO USSPATH=
INVALID XXXXX PARAMETER - DDMMMYY IS NOT A VALID DATE
INVALID XXXXX PARAMETER - HHMM IS NOT A VALID TIME
NO VALID USER(S) SPECIFIED FOR WORKLOAD xxxxxxxx
PARAMETER RUNTYPE IS INVALID: VALID ARE SCAN, USERSCAN OR COLLECT
REMAINDER HAS BEEN SPECIFIED WITHOUT OTHER WORKLOADS
REMAINDER MUST BE NO MORE THAN 8 CHARACTERS
RUNTYPE=USERSCAN CANNOT PROCESS ZMON DATA
SYSTEM MUST BE NO MORE THAN 8 CHARACTERS
SYSTEM NAME IS MISSING
TARGET NUMBER HAS AN INVALID VALUE: IT MUST BE AN 8 DIGIT NUMBER
TARGET= PARAMETER MISSING
THE ABOVE PARAMETER IS UNKNOWN
THE ABOVE PARAMETER HAS ALREADY BEEN SUPPLIED
USER MUST BE NO MORE THAN 8 CHARACTERS
USER NAME OR PATTERN IS MISSINGModule: AVMPPRM
AVM100I ACQUIRE/ZVM Vver (build) INPUT LISTING / DIAGNOSTICS ddmmmyy
Meaning: Header line for Acquire for z/VM showing the build date (as ddmmyy) and the run date
Module: AVMPPRM
AVMx02I Z/VM MONITOR DATA READ FROM datasetname
Meaning: The input data from z/VM MONITOR DATA was read from datasetname
Module: AVMCRUN (x=1), AVMSRUN (x=2) or AVMURUN (x=3)
AVMx03I SYSTEM ID Z/VM VERSION MACH-MOD DATE/TIME LAST IPLAVMx04I name version machine date time
Meaning: Details of the z/VM system processed from MONITOR data
Module: AVMCRUN (x=1), AVMSRUN (x=2) or AVMURUN (x=3)
AVMx05I EARLIEST T.O.D. – date time GMT offset I’VAL timeAVMx06I LATEST T.O.D. – date time
Meaning: Details of the start and end of data processed, the GMT offset and the data interval value seen by Acquire
Module: AVMCRUN (x=1), AVMSRUN (x=2) or AVMURUN (x=3)
AVM107I INTERVAL LENGTH XXXXX AT YYYY-MM-DD HH:MM:SS
Meaning: The interval length for z/VM data is now xxxxx seconds from the specified date and time
Module: AVMCRUN
AVMx08I SUMMARY OF RECORDS BY DOMAIN AND RECORD NUMBERAVMx09I DOMAIN # RECORD # COUNTAVMx10I <n> <n> <n>AVMx10I <n> <n> <n>
Meaning: A summary of the z/VM MONITOR records used by a run of Acquire by domain and record type
Module: AVMCRUN (x=1), AVMSRUN (x=2) or AVMURUN (x=3)
AVM112I COUNT OF RECORDS USED FROM INPUT DATA
Meaning: Header for following count of records used from the input file(s)
Module: AVMCRUN
AVM113I xxxx ELAP=eeee CPU=cccc EXCP=iiii
Meaning: Elapsed time, CPU and I/O in the xxxx phase of a COLLECT run. xxxx is:
READ DATA - Reading and extract data from the ZVMDATA file
SORT DATA - Sorting data to remove duplicates and into processing order
GENERATE - Writing the output file(s)
*TOTALS* - The sum of all the above
Module: AVMCRUN
AVM161E SYSTEM ID IN MONITOR DATA DOES NOT MATCH TARGET xxxxxxxx
Meaning: A COLLECT found MONITOR data for a different system than the TARGET= control card specified. The run will abort.
Module: AVMCRUN
AVM162E NO SYSTEM DATA RECORDS FOUND FOR THE INTERVAL SPECIFIED
Meaning: A COLLECT run found no MONITOR data describing the system within the SDATE/STIME EDATE/ETIME range
Module: AVMCRUN
AVM163E SYSTEM ID oooooooo CHANGED TO nnnnnnnn
Meaning: A COLLECT run found the MONITOR data’s system id changed from oooooooo to nnnnnnnn, which is not allowed. Acquire will terminate with return code 8.
Module: AVMCRUN
AVM190I ACQUIRE/ZVM Vver (build) COLLECT LISTING ddmmmyy
Meaning: Header line for a COLLECT run using MONITOR data showing the version of Acquire for z/VM, the build date (as ddmmyy) and the run date
Module: AVMCRUN
AVM193I INTERVAL START DATE / TIME
Meaning: Header line for a COLLECT run
Module: AVMCRUN
AVM194I ddmmmyy hh:mm:ss
Meaning: Detail line for a COLLECT run showing the start of every MONITOR interval processed
Module: AVMCRUN
AVM199I COLLECTION HAS COMPLETED
Meaning: A COLLECT run of MONITOR data completed OK
Module: AVMCRUN
AVM200I ACQUIRE/ZVM Vver (date) SCAN LISTING ddmmmyy
Meaning: Header line for a SCAN run showing the version of Acquire for z/VM, the build date (as ddmmyy) and the run date
Module: AVMSRUN
AVM299I SCAN RUN HAS COMPLETED
Meaning: A SCAN run completed OK
Module: AVMSRUN
AVM300I ACQUIRE/ZVM Vver (build) USERSCAN LISTING ddmmmyy
Meaning: Header line for a USERSCAN run showing the version of Acquire for z/VM, the build date (as ddmmyy) and the run date
Module: AVMURUN
AVM310I LIST OF UNIQUE VIRTUAL USERS IN MONITOR DATAAVM311I <username>
Meaning: A list of the unique guest user names found in the data that was processed. You may want to review this and determine if you want to group any of these using WORKLOAD= control cards.
Module: AVMURUN
AVM399I USERSCAN HAS COMPLETED
Meaning: A USERSCAN run completed OK
Module: AVMURUN
AVM501D xTOD=xxxxxxxxx K1=yyyyyyyyyyyy K2=zzzzzzzzzzzzz
Meaning: Debug message, for Precisely use only
Module: AVMGNEXT
AVM502I Z/VM VELOCITY VELxxx DATA READ FROM dataset name
Meaning: Velocity Software data was read through DDNAME VELxxx from the listed dataset
Module: AVMVELCR
AVM503I SYSTEM ID ZVM VERSION MACH-MOD DATE/TIME LAST IPL
AVM503I VMD1 6.3.0-1501 2827-400 19APR15 02:57:26
Meaning: Details of the z/VM system processed from Velocity Software data
Module: AVMVELCR
AVM505I START OF FIRST INTERVAL – ddMMMyy hh:mm:ss GMT +00:00 I'VAL hh:mm:ss
Meaning: The start date/time/timezone of Velocity Software data that was processed
Module: AVMVELCR
AVM506I END OF LAST INTERVAL - ddMMMyy hh:mm:ss
Meaning: The end date/time of Velocity Software data that was processed
Module: AVMVELCR
AVM507E KEY3=xxxxxxxxxxxxxx >CPUtype<
Meaning: An invalid CPU type was detected. The program will terminate with a user 911 abend. Contact Precisely Support for assistance, providing the joblog and complete dump.
Module: AVMPATH6
AVM512I COUNT OF RECORDS USED FROM INPUT DATA AND CONTRIBUTING TO THE OUTPUT FILEAVM508I SEGMENT COUNT SIZE (MB) AVM509I xxxxxx nnnnn mmmm.mm
Meaning: Details of the types of information processed from a set of Velocity Software data
Module: AVMVELCR
AVM513I xxxx ELAP=1.654 CPU=0.104 EXCP=1486
Meaning: Elapsed time, CPU and I/O in the xxxx phase of a COLLECT run using data from Velocity Software’s product.
xxxx is:
READ DATA - Reading and extract data from the VELxxx files
SORT DATA - Sorting data to remove duplicates and into processing order
GENERATE - Writing the output file(s)
*TOTALS* - The sum of all the above
Module: AVMVELCR
AVM514W BROKEN SEGMENT IN xxxxxx DATE:yyyymmdd TIME:hhmmss SEG:ssss LEN:nnn
Meaning: A segment of Velocity Software data has a length less than 12 bytes, and is probably caused by the previous segment having an incorrect length. The remainder of the record is ignored. xxxxxx is the DDNAME, ssss is the segment name and nnn is the length.
Module: AVMVELCR
AVM515W TOTAL BROKEN SEGMENTS IN dddddd nnnnnn
Meaning: Some segments of Velocity Software data were detected having lengths less than 12 bytes. The message details the DDNAMEs and the total counts of invalid segments detected. The return code from the step will be set to 4.
Module: AVMVELCR
AVM561E SYSTEM ID IN MONITOR DATA DOES NOT MATCH TARGET xxxxxxxx
Meaning: A COLLECT found Velocity Software data for a different system than the TARGET= control card specified. The run will end with a return code of 8.
Module: AVMCRUN
AVM562E NO SYSTEM DATA RECORDS FOUND FOR THE INTERVAL SPECIFIED
Meaning: A COLLECT run found no Velocity Software input data within the SDATE/STIME EDATE/ETIME range
Module: AVMVELPT
AVM563E SYSTEM ID oooooooo CHANGED TO nnnnnnnn
Meaning: A COLLECT run found the system id in Velocity Software data changed from oooooooo to nnnnnnnn within one set of data, which is not allowed. Acquire will terminate with return code 8.
Module: AVMVELPT
AVM564I NUMBER OF CPS SET TO nn FROM MTRSYS MODEL NUMBER
Meaning: A COLLECT run has set the number of CPs for a machine from Velocity Software data to ‘nn’. Information only.
Module: AVMVELPT
AVM565E NO SYSTEM ID FOUND, CANNOT CONTINUE
Meaning: A COLLECT run has processed data from Velocity Software but could not locate the data segment containing the system ID. This indicates a serious problem with the format of the data, and Acquire will terminate with a return code of 8.
Module: AVMVELPT
AVM590I ACQUIRE/ZVM Vvv.rr.m (ddmmyy) COLLECT LISTING ddMMMyy
Meaning: Header line for a COLLECT run using Velocity Software data showing the version of Acquire for z/VM, the build date (as ddmmyy) and the run date
Module: AVMVELCR
AVM599I COLLECTION HAS COMPLETED, CODE=00
Meaning: Acquire for z/VM has completed processing Velocity Software’s data with return code rr.
Module: AVMMAIN
AVM900I rrrrr RECORDS READ SIZE IS mm.mm MB
Meaning: The number of input records read and the data size
Module: AVMMAIN
AVM901I rrrrr RECORDS IN WORK SIZE IS mm.mm MB
Meaning: The number of records written to the WORK01 and WORK03 files and the data size
Module: AVMMAIN
AVM902I rrrrr RECORDS IN AVMDATA SIZE IS mm.mm MB
Meaning: The number of records written to the AVMDATA file and the data size
Module: AVMMAIN
AVM903I INLINE COMPRESSION CPU=cccc SAVED mm.mm MB
Meaning: Report of the CPU time in seconds taken to compress output records and the size of data saved by doing so, when COMPRESS=Y is in effect
Module: AVMCRUN
AVM904I filename SIZE IS mm.mm MB
Meaning: The name of the USS file written and the data size, when USSPATH= is in effect
Module: AVMMAIN
AVM999I ACQUIRE/ZVM HAS COMPLETED, CODE=00
Meaning: Acquire for z/VM has completed with return code rr.
Module: AVMMAIN
Messages from AVMPUSH
AVMPUSH is a utility to help you automate the copying of data from your mainframe to where Syncsort™ Capacity Management Control Center can process it into your database.
AVP000I AVMPUSH vv.rr.m (ddmmyy) Generate FTP commands
Meaning: Heading line showing the version and build date (ddmmyy) of AVMPUSH
AVP001I Parameters in effect are : <a>,<b>,<c>
Meaning: The parameters in effect for this run are ‘a’ ‘b’ and ‘c’. Each of these will be either ‘Y’ or ‘N’ and their meanings are explained in subsequent AVP002I messages.
AVP002I X=WHAT
AVP002I Y=tgtnnnnnnnn.ready directory will be created
AVP002I N=No directory will be created
AVP002I Y=A quit command will be written
AVP002I N=No quit command will be written
AVP002I Y=A "put <dsn>" command will be written
AVP002I N=A "put //DD:AVMDATA]" command will be written
Meaning: Explanations of the parameters in effect, as set by the user, or defaulted to.
AVP003I //AVMDATA dataset name is <datasetname>
Meaning: This is the dataset name associated with DDNAME AVMDATA
AVP004I xxxx-xxx ssssssss AzVM vxx.yy on DDMMMYY at hh:mm:ss
Meaning: Data from the AVMDATA file shows a machine type of xxxx-xx and a system name of ssssssss. Acquire for z/VM version xx.yy processed this data on DDMMMYY at hh:mm:ss.
AVP005I copy-to name is <yyyymmddhhmmss>_asz<s><tttttttt>.<vvvv>
Meaning: The data in the AVMDATA file will be copied to a new file name as described. The date and time stamp <yyyymmddhhmmss> is taken from the start of the first interval of data in the file, as is the target number <tttttttt>. The file suffix <vvvv> is set to the version of AVMPUSH that is running.
AVP006I rename name is <yyyymmddhhmmss>_asz<s><tttttttt>.<vvvv>
Meaning: The name the AVMDATA file will be copied to is to be renamed to this new name. The details are as for message AVP005I
AVP007I Input data was from Velocity Software’s zMON
Meaning: The data in the AVMDATA file originated from Velocity Software’s zMON product (not IBM’s MONITOR data)
AVP008E JCL parm must be "(Y or N),(Y or N)[,(Y or N)]"
Meaning: The JCL parameters is invalid. It must comprise only of Y or N characters separated by commas. It can be completely omitted for defaults of ‘Y,Y,Y’ or must be 3 or 5 characters in length
AVP009E EOF on //AVMDATA before 3 records read
Meaning: The AVMDATA file had fewer than 3 records in, and no valid data
AVP010E Invalid date in xxxx record, ending
Meaning: The record type 5002 or 7002 had an invalid date in. If this was caused by Acquire for z/VM, contact ActionLine to report the issue
AVP011E Data must be from Acquire for zVM
Meaning: The data in the AVMDATA file does not appear to be from Acquire for z/VM
AVP012I Direct invocation of FTP will be attempted
Meaning: One-step mode has been requested and VMPUSH will attempt to invoke FTP to undertake the file copying/renaming requested.
AVP013I No !PUSH line found in //AVMFTP, aborting
Meaning: One-step processing was requested but no !push or !PUSH string was found in the FTP statements to indicate here the ‘put’ and ‘rename’ commands should be written.
AVP099I AVMPUSH has ended
Meaning: AVMPUSH has completed.
AVP100I Completing FTP command creation
Meaning: One-step mode has been requested and the FTP commands and files are being prepared
AVP101I Invoking FTP...
Meaning: AVMPUSH is invoking FTP to attempt the copying and renaming of files
AVP102I FTP return code was xxxxx, FTP messages follow
Meaning: AVMPUSH has invoked FTP and the return code was xxxxx. Messages from FTP are printed after this one to determine if the copying and renaming succeeded, along with any errors if it did not.
Messages from the error trapping routine (AVMESTAE)
If Acquire abends, a special exit is invoked to attempt to analyze the location and help point out what was being processed at the time. This routine can write messages as follows to the //VMMSGS file that will assist Precisely Support service with the diagnosis and resolution of a problem:
AZE001I abnd DETECTED AT psw : module+offset
Meaning: An abend abd has occurred at location psw in storage, which resolves to Acquire module module at offset offset.
AZE002I previous bytes
AZE002I op-code instruction R1=address-1 -> xxxxxxxx
AZE003I R2=address-2 -> xxxxxxxx
AZE004I OP=xxxxxxxx -> xxxxxxxx
R0=vvvvvvvv R1=wwwwwwww R2=xxxxxxxx R3=xxxxxxxx
R4=vvvvvvvv R5=wwwwwwww R6=xxxxxxxx R7=xxxxxxxx
R8=vvvvvvvv R9=wwwwwwww RA=xxxxxxxx RB=xxxxxxxx
RC=vvvvvvvv RD=wwwwwwww RE=xxxxxxxx RF=xxxxxxxx
Meaning: The failing instruction is op-code and the full instruction is instruction. The 8 bytes prior this are printed in previous bytes. The constituent addresses of the instruction are resolved as address-1 and address-2 and if some other information can be extracted, this is printed in the xxxxxxxx fields. The contents of all general registers are also printed.
AZE005I DUMP OF RECORD BEING PROCESSED
Meaning: A dump of the record being processed by Acquire (either an incoming z/VM MONITOR record, or an extract record) follows.
AZE006I GLOBAL DATA IS AT address
ffffffff=vvvvvvvv ffffffff=vvvvvvvv ffffffff=vvvvvvvv ffffffff=vvvvvvvv ffffffff=vvvvvvvv ffffffff=vvvvvvvv
Meaning: The Acquire global area is located in storage at address address and various other key field values are printed.
AZE007I SUPERVISOR CALL - svcdetail
Meaning: The failing instruction was an SVC (Supervisor Call) as detailed.