* copyright (C) 1984-2019 merrill consultants dallas texas usa



Yüklə 28,67 Mb.
səhifə297/383
tarix17.01.2019
ölçüsü28,67 Mb.
#98988
1   ...   293   294   295   296   297   298   299   300   ...   383

V. IMS Technical Notes

VI. SAS Technical Notes

VII. CICS Technical Notes

VIII. Incompatibilities and Installation of MXG 13.13.

IX. Online Documentation of MXG Software.

X. Changes Log
I. MXG Software Version Status.
1. MXG Software Version 13.13, dated January 20, 1996, was shipped

with newsletter, NEWSLETTER TWENTY-NINE.


Major enhancements added in MXG 13.13 dated Jan 20, 1996:
Added after Newsletter 29 was sent to the printer:
Support for 4-digit UCBs in DCOLLECT, ASMVTOC and ASMVVDS.

Support for DOS/VSE POWER 5.2 Accounting Records

Support for MVS Catalog records (Exported with IDCAMS)
Included in Newsletter 29 list of enhancements in MXG 13.13:
Support for BETA 93 Release 1.06.50 (INCOMPATIBLE)

MXGVERSN variable added to TYPE70 and RMFINTRV.

Support for Frye Systems measurement of Netware LANS

Support for Blue Line Software 4.03 and 4.04 (INCOMPAT) and 4.10.

Sample conversion of DBaseIII files into SAS datasets.

Workaround for SAP and IBM CICS 2.1 interleaved records.

ASCII execution of BUILDPDB and PROC FORMATS now transparent.

TESTMWX for improved CPU capture in User records.


Major enhancements added in MXG 13.09 dated Jan 10, 1996:
Support for DFSMS/MVS 1.3 DCOLLECT records (compatible).

Support for DFSMS/MVS 1.3 VSAM RLS fields in type 64 (compatible).

Support for DFSMS/MVS 1.3 VSAM RLS fields in type 42 (compatible).

Support for MVS/ESA 5.2.2 Open Edition OMVS type 92 (INCOMPATIBLE).

Support for MVS/ESA 5.2.2 Open Edition OMVS type 30 (compatible).

Sample HSM reports and analysis suggestions

TYPE6 INPUT STATEMENT EXCEEDED for PSF type 6 with OW10067.

CICS/ESA 4.1 corrections (TRANTYPE, ELAPSTM, ENDTIME, IRESPTM)

CICS/ESA 3.3 UNEXPECTED STATISTICS with STILEN=0 protection.

MEASUREWARE (old HP-PCS) CPU time error in HPxxGLOB,HPxxAPPL.

Landmark TMON for UNIX enhancements, corrections and errors.
Major enhancements added in MXG 13.08 dated Dec 15, 1995:
Support for MVS Solution's MVS Thruput Manager SMF record.

Support for VM/ESA SQL/DS Remote User Accounting Record (INCOMPAT)

Support for Landmark's TMON for UNIX.

Support for TANDEM D20 and D30 and D40 releases.

Support for DB2 4.1 IFCIDs 221, 222, and 231.

Support for IDMS 12.01 (INCOMPATIBLE) was not correct until 13.08.

Support for TOPSECRET 4.4 and 5.0 (INCOMPATIBLE) added.

Support for HSM ABARS ABACKUP/ARECOVER FSR segment validated.

Support for SAP 5.0 INCOMPATIBLE changes to type 110 journal data.

MAINTLEV 7 of MXG Tape Mount and Allocation Monitor.

Replacement for CICINTRV available for testing.

"XMXGSUM" architecture now replaces VMXGSUM.

SYSNAME and SYSPLEX added to PDB.JOBS/STEPS/PRINT.

Default ASUMCICS summarization now includes USER.

JESNR may show only four digits in TYPE26; IBM lied in ESA 5.2

DEVPLX (duplex volume) address wrong, IBM worrying.


Major enhancements added in MXG 13.07 dated Oct 30, 1995:
Support for DB2 4.1.0 type 100 and 101 SMF records.

Support for STK SILO HSC VIEW Command Subtype 8 SMF record.

Support for MODEL204 Release 3.0

CICS/ESA 4.1 CICSTRAN variables STRTTIME/ENDTIME now GMT-corrected.

New IMACSPCK exit for SPIN decision override.

New IMACZDAT localizes creation of ZDATE, for ease in reruns.

Corrections for Landmark Version 2 TMDB support.
Major enhancements added in MXG 13.06 dated Oct 10, 1995:
ASMTAPES revision MAINTLEV 6 is now included, resolves errors.

TYPETMON (TMON CICS 1.3) must now use RECFM=VB instead of RECFM=U.

Support for Landmark TMON for DB2 Version 2.

Support for Tandem D20 MEASURE CPU, Disk, and Process data records.

Support for COM-PLETE Version 4.6 SMF record.

Support for ISOGON Soft Audit Version 4.1.

Support for HSM ABARS ABACKUP/ARECOVER FSR segment.

Support for APAR OW14717 and APAR OW16039 for SMF type 42.

Support for Omegamon for MVS/ESA V400 adds variables.

Support for 3590 tape drives now complete.

Support for APAR OW11142 adds new fields to TYPE64.

Support for Software Engineering of America's TRMS SMF record.

MXG 13.01-MXG 13.05, IMACJBCK caused deletion of RACF, ACF2 and DB2

observations with job name of nulls. See Change 13.183.

ANALDB2R may still get FORMAT NOT FOUND, assorted minor DB2 fixes.
Major enhancements added in MXG 13.05 dated Aug 21, 1995:
Added after Newsletter TWENTY-EIGHT was printed:

Support for MVS/ESA 5.2.2.

Support for Candle Omegamon 300 SMF record (incompatible).

Support for Landmark's TMON/MVS 1.2/1.3 additional subtypes.

Preliminary support for 3590 tape drives.

Correction for VM/ESA INVALID CONTROL RECORD error.

Announced in Newsletter TWENTY-EIGHT:

Support for the year 2000 (see MXG Technical note in NEWSLTRS, NL28)

Support for OpenMVS File System I/O type 92 SMF record.

Support for MVS/ESA 5.2 System Logger Data type 88 SMF record

Support for EREP (SYS1.LOGREC) records.

Deaccumulation of HMF records.

Final (?) Correction to ANALDB2R Statistics and Audit Reports.

If you use either the DB2 Statistics reports or DB2 Audit Reports,

you must request MXG 13.05 for the ANALDB2R corrections to errors

introduced in MXG 12.12 (Statistics) or MXG 13.01 (Audit) that were

not fixed until now (I apologize for the careless coding and lack

of validation of report output that took seven iterations to fix).

The Audit errors were actually corrected in 13.03, but Statistics

still had four values that were not corrected until MXG 13.05.

The more-commonly-used DB2 Accounting Reports had no errors.

MAINTLEV 6 of ASMTAPES was listed in Newsletter 28, but is not on

the MXG 13.05 tape; see text of Change 13.163.
Major enhancements added in MXG 13.04 dated Jul 31, 1995:
Support for NetCompress SMF records.

Support for Packet/Main SMF records.

Support for Kodak AXCIS Optical Disk SMF records.
Major enhancements added in MXG 13.03 dated Jul 19, 1995:
More fixes for DB2 Statistics Reports, a fix for DB2 Audit Reports.

TYPE116 (MQM) validation and correction.


Major enhancements added in MXG 13.02B dated Jul 6, 1995:
Correction to DB2 Statistics Summary and Audit Reports

MXG Position Paper on Support for Year2000 in member YEAR2000.


Major enhancements added in MXG 13.02A dated Jun 28, 1995:
Correction to DB2 PMSSTA01/02 Statistics Summary Reports.

Final (?) revisions to XMXGSUM.


Major enhancements added in MXG 13.02 dated Jun 19, 1995:
Support for MVS/ESA 5.2 (compatible) changes 24, 30, and 42 records.

Support for OPC Release 3.0 (INCOMPATIBLE).

Support for DFSORT Release 13.0 (INCOMPATIBLE).

Support for TMS (CA-1) Release 5.1 (compatible).

Support for Antares' HURON ObjectStar SMF record.

Support for TYPE32 APARS OW10393 (causes error) and OW12856 (none).

Support for SAP Release 5.0 CICS accounting in type 110.

Support for ACS Wylbur Accounting SMF record

Support for Sterling SAMS Storage Automation SMF record.

Support for LEGENT's AUTOMATE SMF record.

DB2 Audit SQL text corrections.

Support for APAR OW08641 for NPM Version 2.2


Major enhancements added in MXG 13.01 dated May 3, 1995:
Support for NETSPY Release 4.6 (compatible), divide by zero fixes.

Support for HP PCS current version on HPUX, AIX, and SUN unix.

Support for OS/400 Version 3.1.0 (was wrong in MXG 12.12/12.12A).

Support for TCP/IP APAR PN69321-PN69322.

Support for Sterling SOLVE NCL CPU-time accounting user SMF.

Support for HMF SMF record subtypes 4 and 5.

Support for APAR OW04653 added variables to TYPE74ST dataset.

Support for IBM's IRRDBU00 RACF Database Unload.

ASMRMFV 0C4 correction and enhancements for RMF VSAM processing.

ANALCNCR enhancements and validation.

XMXGSUM enhancements and validation.

TYPE116 (MQM) validation and correction.


Major enhancements added in MXG 12.12A dated Mar 20, 1995:
Twelve MXG 12.12 members had errors that are now fixed:
ANALCNCR ANALDB2C ANALDB2R ANALPATH ANALTALO IMACICSA

TRNDTALO VMAC80A VMAC110 VMACILKA TYPEMON8 TYPETMON


Support for Memorex/Telex LMS Version 3.1 (INCOMPATIBLE).
All of these enhancements are described in the Change Log, below.
Table of availability dates for the IBM products and MXG version:
Availability MXG Version

Product Name Date Required


MVS/ESA 4.1 Oct 26, 1990. 8.8

MVS/ESA 4.2 Mar 29, 1991. 9.9

MVS/ESA 4.2.2 Aug 1991. 9.9

MVS/ESA 4.3 Mar 23 1993. 10.10

MVS/ESA 5.1.0 - compatibility Jun 24, 1994 12.02

MVS/ESA 5.1.0 - Goal Mode May 3, 1995 13.01

MVS/ESA 5.2.0 Jun 15, 1995 13.05

MVS/ESA 5.2.2 Oct 19, 1995 13.09

CICS/ESA 3.2 Jun 28, 1991. 9.9

CICS/ESA 3.3 Mar 28, 1992. 10.01

CICS/ESA 4.1 Oct 27, 1994. 13.09

CICS/ESA 4.2 when G.A. ??.??

CRR 1.6 Jun 24, 1994. 12.02

DB2 2.2.0 1990 8.8

DB2 2.3.0 Oct 28, 1991. 10.01

DB2 3.1.0 Dec 17, 1993. 13.02A

DB2 4.1.0 Nov 7, 1995 13.07

DFSMS/MVS 1.1 Mar 13, 1993. 11.11

DFSMS/MVS 1.2 Jun 24, 1994. 12.02

DFSMS/MVS 1.3 Dec 29, 1995. 13.09

NPM 2.0 Dec 17, 1993. 12.03

NPM 2.2 Aug 29, 1994. 12.05

VM/ESA 1.1.1 Dec 27, 1991. 10.01

VM/ESA 2.0 Dec 23, 1992. 10.04

VM/ESA 2.1 Jun 27, 1993. 12.02

VM/ESA 2.2 Nov 22, 1994. 12.06


Table MXG support for non-IBM products:
Availability MXG Version

Product Name Date Required


Landmark

The Monitor for DB2 Version 2 13.06

The Monitor for CICS/ESA 1.2 - 12.12

The Monitor for CICS/ESA 1.3 - 12.12A

The Monitor for MVS/ESA 1.3 - 12.05

Candle


Omegamon for CICS V300 User SMF 12.05

Omegamon for CICS V400 User SMF 13.06

Omegamon for IMS V110 (ITRF) 12.12

Omegamon for MVS - last MXG change 1992 12.12

Omegamon for DB2 Version 2.1/2.2 13.05

Omegamon for VTAM V160 12.04A

Omegamon for SMS V100/V110 12.03

Boole & Babbage

IMF 3.1 (for IMS 5.1) 12.12

Memorex/Telex

LMS 3.1 12.12A

II. MXG Technical Notes.


III. MVS Technical Notes after Newsletter TWENTY-NINE.

IV. DB2 Technical Notes.

V. IMS Technical Notes.

VI. SAS Technical Notes.

VII. CICS Technical Notes.

VIII. Incompatibilities and Installation of MXG 13.13.


1. Incompatibilities introduced in MXG 13.13 (since MXG 12.12):
a- IMACs that were changed (if they exist in your USERID.SOURCLIB, you

must refit your tailoring, starting with the new IMAC member):


IMACPDB (Change 13.198)

IMACJBCK (Change 13.183)


b- Other incompatibility changes:
Member FORMATS cannot be executed as-is under SAS Version 5.18,

but can be tailored if you are still running that archaic version.

See Change 13.127
User-written invocations of VMXGSUM with OUTCODE= to recalculate

the DATETIME= variable may be wrong. See Change 13.152.


c- These products were incompatibly changed by their vendor, and they

require MXG 13.xx as indicated:


Memorex/Telex LMS 3.1 (Change 12.326, MXG 12.12A)

OPC Release 3.0 (Change 13.092, MXG 13.02)

DFSORT Release 13 (Change 13.092, MXG 13.02)

Hipercache 4.1.x (Change 13.120, MXG 13.03)

BETA 93 Release 1.06.50 (Change 13.304, MXG 13.09)

OMEGAMON/MVS Version 300 (Change 13.170, MXG 13.05)

IDMS 12.01 Maint 9506 (Change 13.223, MXG 13.06)

TMON/CICS 1.3 (Change 13.204, MXG 13.06)

SAP 5.0 type 110 journal (Change 13.261, MXG 13.08)

TOPSECRET 4.4/5.0 (Change 13.254, MXG 13.08)

OPEN EDITION MVS 5.2.2 (Change 13.313, MXG 13.13)

VM/ESA SQL/DS Accounting (Change 13.xxx, MXG 13.yy)

IMS 5.1 (Change 13.265, MXG 13.xx)

Model204 Release 3.0 (Change 13.249, MXG 13.xx)

TMON/DB2 Version 2 (Change 13.224, MXG 13.xx)

TYPE42 APAR OW14717 (Change 13.217, MXG 13.xx)


2. Installation and re-installation procedures are described in detail;

in member INSTALL (which also lists common Error/Warning messages a

new user might encounter), and sample JCL is in member JCLINSTL:

Summary:


a. Install member MXGSAS as JCL Procedure MXGSAS in your PROCLIB.

b. Allocate a 105-cyl PDS: MXG.V1313.MXG.SOURCLIB, and use IEBUPDTE

to read the MXG tape to create the 2937+ member Source Library.

c. Allocate a 1-cyl PDS: MXG.V1313.USERID.SOURCLIB for your site

"Installation Tailoring" Source Library. Installation specific

tailoring (like telling MXG your shift hours, which performance

groups are TSO, CICS, etc.) is done by copying and modifying MXG

source members into V1313.USERID.SOURCLIB.

d. Allocate a 1-cyl SAS Data Library: MXG.V1313.MXG.FORMATS and

execute SAS to create the library of Formats required by MXG.

e. If this is the initial install of MXG, tailor these members into

your MXG.V1313.USERID.SOURCLIB tailoring library:

IMACACCT (Account Length),

IMACSHFT (Shift Definitions),

IMACWORK (Performance Group to Workload mapping), and

IMACSPIN (for BUILDPDB).

Each IMAC member is self-documenting, and IMACAAAA is the index

of all of the IMACs. You should at least scan IMACAAAA to see

the acronyms MXG uses for the many products MXG supports.

e. If re-installing MXG, copy your existing USERID.SOURCLIB library

members into the MXG.V1313.USERID.SOURCLIB. Then, compare the

members in your USERID.SOURCLIB with the list of members that

were incompatibly changed (above, in this section) in this MXG.

If any of the incompatibly changed members exist in your dataset

MXG.V1313.USERID.SOURCLIB, then you must reinstall your site's

tailoring for that IMAC, starting with the IMAC member from the

MXG 13.13 Source Library.

f. EDIT and submit member JCLTEST6 to verify that your tailoring

did not create any errors.
g. EDIT and submit JCLPDB6 to create a Daily PDB for testing. Or

use the TYPE.... members to process specific data sources, use

the ANAL.... members for report examples, the GRAF.... members

for SAS/GRAPH reports.


You have now installed MXG 13.13 in its own set of libraries. When

parallel testing is complete and are ready to implement MXG 13.13

in production, rename your three current MXG Production Libraries

(MXG.MXG.SOURCLIB, MXG.USERID.SOURCLIB, and MXG.MXG.FORMATS) to

(MXG.BACK.MXG.SOURCLIB, MXG.BACK.USERID.SOURCLIB, MXG.BACK.MXG....)

and rename the MXG.V1313.x.y libraries to their Production names!


Again, detailed installation instructions are in member INSTALL
Always read comments in the CHANGES member for compatibility issues, as

well as for any last minute changes.


Whenever you install changes or test a new version of MXG (or even your

own reports), be extra careful to look on the SAS log for any real error

conditions. Search for all occurrences of "ERROR:", "ERROR :", " NOT "

"UNINITIALIZED", "TRUNCATED", "NEVER BEEN", "NOT FOUND", "CONVERT",

"APPARENT", and "NOT CATLGD", as they usually indicate a serious error.
A PROC PRINT and a PROC MEANS of each new MXG-built SAS dataset can help

you to understand their contents, and should be used to examine any

unusually large, negative, or suspicious values. Print all variables in

the dataset, and read the variable's descriptions in its ADOC member.


IX. Online Documentation of MXG Software.
Since 1994, the contents of the two MXG Books, (the 1984 MXG Guide, and

the 1987 MXG Supplement) are contained in the MXG Source Library, as are

all MXG Technical Newsletters and all MXG Changes, so all MXG

documentation is actually online in the software itself; even the

Installation Instructions are online, in members INSTALL/JCLINSTL!
ACHAPxxx members are the text of the 42 chapters from the two MXG books,

to which the text from newsletters and changes has been added. Some of

these chapters are still rough; while some of the chapters have actually

been completely revised, many of these ACHAPxxx are little more than a

concatenation of the two original chapters, often without the figures

or tables. The revision is work still in progress!


Members ADOCxxxx are what were in Chapter FORTY, and should be the first

place you look for information about MXG variables and/or datasets. The

ADOCxxxx members alphabetically describe each dataset and all variables

that are created by product xxxx, the instructions on how to enable that

product, bibliography of the vendor documentation, sample PROC PRINT and

PROC MEANS of real data, references to MXG reports that use these data,

and the MXG member names that you use to process that product. While

this too is work in progress, the most heavily used data sources,

especially the common SMF records, have been revised and are up to date.
There is an IMACxxxx member for every product supported by MXG. Once

you know the xxxx suffix for a product, you then know the names of all

of the MXG members for that product, because of MXG naming conventions:
IMACxxxx - Defines record IDs, and the _Lyyyzzz and _Kyyyzzz macros

that name the dataset(s) created from product xxxx.


ADOCxxxx - "Chapter FORTY" style dataset and variable documentation of

all datasets created from product xxxx, with sample output.

VMACxxxx - The "real" source code member, often extensively commented.

TYPExxxx - Standalone member to test or process product xxxx records.

ASUMxxxx - Summarization example (only for some products)

TRNDxxxx - Trending example (only for some products)

ANALxxxx - Reporting/analysis example (only for some products)

GRAFxxxx - SAS/GRAPH report example (only for some products)

EXyyyzzz - OUTPUT exit for tailoring of each MXG dataset, not used by

most MXG sites, but powerful if needed. There can be more

than one dataset created from one product. The yyyzzz

suffix of the EXyyyzzz member name is the same as the

suffix of "_L" and "_K" macros defined in the IMACxxxx for

its product. See Using the MXG Exit Facilities in ACHAP33.


Member IMACAAAA is an index of all IMACs, and is the best place to begin

to find what xxxx suffix Merrill chose for which product! You can often

find additional documentation by searching members NEWSLTRS or CHANGESS

for the xxxx suffix.


Member CHANGES identifies this Version and Release of MXG Software, and

describes all changes made in this Release, plus new technical notes.


Member CHANGESS contains each of the CHANGES members from each version

of MXG, so this member contains ALL changes ever made to MXG Software.

Since each MXG change lists the names of the members that were added or

altered, names the new product/version supported by a change, or lists

error messages corrected by a change, this member is designed to be read

online (with SPF BROWSE); you can search for specific product acronyms

(CICS, MVS/ESA, etc.), or the MXG member name or anything else. Many of

the changes are actually mini-tutorials, especially for new products.


Member NEWSLTRS contains the text of all newsletters. You can search

NEWSLTRS for product name or acronym to find all of Dr. Merrill's

published and unpublished technical papers, technical notes announcing

enhancements in new operating systems or subsystems, new datasets and

products, important APARs and PTFs, and other technical information of

importance to MXG users. (Since the Change Log that is printed in each

newsletter is in member CHANGESS, it is not repeated in NEWSLTRS.) MXG

Technical Newsletters are typically published twice a year, with one

printed copy sent to each licensed site's technical addressee.
Member DOCVER lists alphabetically ALL datasets and variables that are

built by this MXG Software Version, abbreviated to a line per variable.


Members DOCVERnn are the "delta-documentation" between MXG versions, and

list only those datasets and variables that were added/deleted/changed

by version "nn", so you can identify when a variable/dataset was added.
Finally, remember that MXG is source code, and you can often find your

answer by BROWSING the source members, especially the VMACxxxx members.

The MXG Variable name is frequently the vendor's field name, or the

vendor's field name is often in a comment adjacent to the variable's

INPUT, so you can cross reference MXG to the vendor's documentation.
The migration from print to online is clearly work in progress, but at

least the two books are now machine readable! When all 42 chapters

are completely revised and updated in the source library, I will decide

which, if any, will also be made available in printed form, but the

primary media for all future MXG documentation will be these members of

the MXG source library, which can be immediately updated in each new

version of MXG as changes occur.
X. Changes Log
==========================Changes Log=================================
You MUST read each Change description to determine if a Change will

impact your site. All changes have been made in this MXG Library.


Member CHANGES of the MXG SOURCLIB will always be more accurate than

the printed changes in a Newsletter, because the software tapes are

created after the newsletter is sent to the printer!
Member CHANGES always identifies the actual version and release of

MXG Software that is contained in that library.


The actual code implementation of some changes in MXG SOURCLIB may be

different than described in the change text (which might have printed

only the critical part of the correction that can be made by paper).
Scan each source member named in any impacting change for any comments

at the beginning of the member for additional documentation, since the

documentation of new datasets, variables, validation status, and notes,

are often found in comments in the source members.


Alphabetical list of important changes after MXG 12.12:
Dataset/

Member Change Description


Many 13.190 Format of UOWTIME changed to DATETIME25.6 everywhere.

Many 13.198 Support for 3590 tape drives.

ADOCFRYE 13.317 Sample conversion of DBaseIII files into SAS datasets

ANALALL 13.076 Print of All SMF records from a job was enhanced.

ANALAPAF 13.014 Semicolon missing in report program.

ANALCISH 13.046 Report enhancements for CICS Shutdown reports.

ANALCISH 13.113 CICS Shutdown may cause NOTSORTED error.

ANALCISH 13.274 Lots of page ejects corrected.

ANALCNCR 13.036 Validation closed several exposures.

ANALCNCR 13.047 ANALCNCR failed when invoked by ANALTAPE or ANALMTP.

ANALCNCR 13.280 Correction of Dataset Not Found condition.

ANALDB2C 12.318 NO MATCHING IF error because colon vice semicolon.

ANALDB2R 12.328 Syntax errors with PMACC01 or PMACC02 report.

ANALDB2R 13.042 DBID/OBID mapping enhanced to include timestamp.

ANALDB2R 13.058 BY VARIABLE STRTTIME IS NOT ON INPUT DATA error.


Yüklə 28,67 Mb.

Dostları ilə paylaş:
1   ...   293   294   295   296   297   298   299   300   ...   383




Verilənlər bazası müəlliflik hüququ ilə müdafiə olunur ©muhaz.org 2024
rəhbərliyinə müraciət

gir | qeydiyyatdan keç
    Ana səhifə


yükləyin