Acquire for z/VM Messages and Codes - syncsort_capacity_management - 12 - 12.40

Syncsort Capacity Management Installation Guide

Product type
Software
Portfolio
Integrate
Product family
Syncsort
Product
Syncsort Capacity Management
Version
12.40
Language
English
Product name
Syncsort Capacity Management
Title
Syncsort Capacity Management Installation Guide
Topic type
How Do I
Copyright
2023
First publish date
1985

This section lists the messages that Acquire for z/VM may produce along with the return codes associated with any problems.

In the event of a major logic error or data problem, Acquire may issue a user 911 abend and produce a dump. Inform Precisely Support if this occurs, and be prepared to send in the dump and a sample of the input data that caused it. If you need to send in data to Precisely to aid diagnosis of the problem, use the process documented in the section "Sending z/OS or z/VM data to Precisely Support" of the Syncsort Capacity Management User Guide.

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 MISSING

Module: 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 LIST­ING     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 data­set 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 main­frame 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 AVM­PUSH

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 mes­sages.

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 mes­sages 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.