The following principal keywords are used with TSSCHART:
The optional parameters for each keyword can be separated by commas or spaces—for example, CHART(ACIDS,RESOURCE,VCA) or CHART(ACIDS RESOURCE VCA).
If the optional parameters for a keyword exceed the length of the line, end the line with a parenthesis. Begin the next line with the keyword followed by the remainder of the parameters in parentheses. An example follows:
DIV(div,div,div,div,.....................) DIV(div,*EJECT*)
This rule applies to all keywords with multiple optional parameters that might exceed the length of the line.
Note: For information about TSSCHART error messages and abend codes, see the Messages and Codes.
The CHART keyword determines the data to include in the chart.
This keyword has the following format:
CHART(ACIDS,RESOURCE,STATS,SCA,LSCA,ZCA,VCA,DCA)
Includes the zone, division, department, profile, group, and user names in the chart. If supplied, profiles, groups, and users print in list format. This value is the default.
Includes resource ownership elements on the chart (resources owned by the zone, division, department, profile, groups, and users). If you specify ACIDS with RESOURCE, the product omits resources owned by profiles, groups, and users, and the product prints the information in list format. If you do not specify ACIDS, profile, group, and user information—including owned resources—prints in box format.
Includes Security File statistics (for example, record sizes) with each block on the chart.
Includes resources owned by the MSCA and the SCAs on the chart. This parameter implies CHART(RESOURCE).
Includes resources owned by the MSCA and the LSCAs on the chart. This parameter implies CHART(RESOURCE).
Includes resources owned by zonal administrators on the chart. This parameter implies CHART(RESOURCE).
Includes resources owned by divisional administrators on the chart. This parameter implies CHART(RESOURCE).
Includes resources owned by departmental administrators on the chart. This parameter implies CHART(RESOURCE).
Example: List ACIDs and Show Records Sizes and Page Ejects
In this example, an MSCA needs a listing of all ACIDs in the Security File as well as resource ownership. In addition, the MSCA wants to know the size of the ACID records on the Security File and page ejects on new divisions.
CHART(ACIDS,RESOURCE,SCA,LSCA,ZCA,VCA,DCA,STATS) DIV(*EJECT*)
Example: List ACIDs, List Record Sizes, and Request Separate Pages for New Divisions
In this example, an SCA only wants a chart of all ACIDs in the Security File accompanied by the record size of the ACID. The entry requests separate pages for each new division.
CHART(ACIDS,STATS) DIV(*EJECT*)
Example: Chart All Departments Not Belonging to Divisions
In this example, an SCA needs to chart all departments not belonging to divisions:
CHART(ACIDS) XDEPT(*DIV*)
Example: List Data Sets and Volumes Within a Division
In this example, a VCA wants to obtain a listing of data sets and volumes within his division:
CHART(RESOURCE) RESOURCE(DATASET,VOLUME)
Example: Create a Chart with Users from Specific Departments
In this example, a VCA needs a chart containing only users in specific departments to which they belong:
CHART(ACIDS) PROF(*NONE*) DEPT(SYSTEMS)
Example: List Specific Divisions and Departments; List ACID and Resource Information; and Set Up Page Ejects
In this example, an SCA wants to list a particular division and the department(s) attached to it. He also needs all ACIDs and owned resources, who owns the resources, and the size of the ACID records of the Security File. A page eject will occur when a division is to be charted.
CHART(ACIDS,RESOURCE,VCA,DCA,STATS) RESOURCE(ALL) DIVISIOM(DEVLDIV *EJECT*) DEPT(*DIV*)
Example: Generate List Form for Profile, Group, and User ACIDs
In this example, an SCA wants to see the ACIDs and ACID names of all records in the security file. He also wants to see record size statistics and format the output for printing in portrait layout on 8½x11in. paper.
CHART(ACIDS,STATS) LAYOUT(PO)
After the SCA submits this JCL, the product produces the following output:
| +--------------------------------------------------------------+
| | ACID: SAMPZONE TYPE: (ZONE) |
+--| ACID NAME: SAMPLE ZONE ACID SIZE: 256 |
| |
| SECURITY ADMINISTRATOR INFORMATION |
| |
| ACID: SAMPZCA TYPE: (ZCA) |
| ACID NAME: SAMPLE ZCA ACID |
+--------------------------------------------------------------+
|
| +--------------------------------------------------------------+
| | ACID: SAMPDIV TYPE: (DIV) |
+--| ACID NAME: SAMPLE DIVISION ACID SIZE: 512 |
| |
| SECURITY ADMINISTRATOR INFORMATION |
| |
| ACID: SAMPVCA TYPE: (VCA) |
| ACID NAME: SAMPLE VCA ACID |
+--------------------------------------------------------------+
|
| +--------------------------------------------------------------+
| | ACID: SAMPDEPT TYPE: (DEPT) |
+--| ACID NAME: SAMPLE DEPARTMENT ACID SIZE: 1024 |
| |
| SECURITY ADMINISTRATOR INFORMATION |
| |
| ACID: SAMPDCA TYPE: (DCA) |
| ACID NAME: SAMPLE DCA ACID |
+--------------------------------------------------------------+
|
+-- (PROF) SAMPPROF - SAMPLE PROFILE ACID
| < SIZE = 768 >
|
+--(GROUP) SAMPGRP - SAMPLE GROUP ACID
| < SIZE = 512 >
|
+-- (USER) SAMPUSR1 - SAMPLE USER ACID #1
< SIZE = 256 >
The PROF, GROUP, and USER ACIDs are listed rather than being contained in a box like the ZONE, DIV, and DEPT ACIDs. Also, the record size of the ACID is shown if CHART(STATS) is supplied. The CHART(ACIDS) keyword always produces PROF, GROUP, and USER ACIDs in this format.
Example: Generate Box Form for Profile, Group, and User ACIDs
In this example, an MSCA needs a listing of all ACIDs in the Security File as well as resource ownership for ZONE, DIV, DEPT, PROF, GROUP, and USER ACIDs:
CHART(RESOURCE,STATS)
After the MSCA submits this JCL, the product produces the following output:
| +--------------------------------------------------------------+
| | ACID: SAMPZONE TYPE: (ZONE) |
+--| ACID NAME: SAMPLE ZONE ACID |
| RESOURCES OWNED: |
| TYPE: NAME: |
| +-- <<< SAMPZONE OWNS NO RESOURCES REQUESTED >>> |
| |
| SECURITY ADMINISTRATOR INFORMATION |
| |
| ACID: SAMPZCA TYPE: (ZCA) |
| ACID NAME: SAMPLE ZCA ACID |
+--------------------------------------------------------------+
|
| +--------------------------------------------------------------+
| | ACID: SAMPDIV TYPE: (DIV) |
+--| ACID NAME: SAMPLE DIVISION ACID |
| RESOURCES OWNED: |
| TYPE: NAME: |
| +-- <<< SAMPDIV OWNS NO RESOURCES REQUESTED >>> |
| |
| SECURITY ADMINISTRATOR INFORMATION |
| |
| ACID: SAMPVCA TYPE: (VCA) |
| ACID NAME: SAMPLE VCA ACID |
+--------------------------------------------------------------+
|
| +--------------------------------------------------------------+
| | ACID: SAMPDEPT TYPE: (DEPT) |
+--| ACID NAME: SAMPLE DEPARTMENT ACID |
| RESOURCES OWNED: |
| TYPE: NAME: |
| +--($SAMPRES) ALLRES |
| |
| SECURITY ADMINISTRATOR INFORMATION |
| |
| ACID: SAMPDCA TYPE: (DCA) |
| ACID NAME: SAMPLE DCA ACID |
+--------------------------------------------------------------+
|
|
| +--------------------------------------------------------------+
| | ACID: SAMPPROF TYPE: (PROF) |
+--| ACID NAME: SAMPLE PROFILE |
| RESOURCES OWNED: |
| TYPE: NAME: |
| +--($SAMPRES) PROFRES |
+--------------------------------------------------------------+
The PROF ACID is contained in a box like the ZONE, DIV, and DEPT ACIDs. Also, each box for the ACIDs has its owned resources listed or an appropriate message if the ACID does not own any resources. If CHART(ACIDS) is not supplied, PROF, GROUP, and USER ACIDs always print in this format.
The RESOURCE keyword specifies the class resources to include on the resource chart.
This keyword has the following format:
[ (ABSTRACT,APPLICATION,CICS,DATASET, ]
RESOURCE [ FIELD,GENERAL,IDMS,IMS,PROGRAM, ]
[ TERMINAL,TSO,VM,VOLUME,ALL) ]
Note: In addition to the following parameters, you can also supply user-defined resources in the Resource Descriptor Table (RDT) as parameters to the RESOURCE keyword.
Includes abstract resources on the chart.
Includes applications on the chart.
Includes CICS resources (DCT, FCT, PPT,...).
Includes DSNAME resources.
Includes user‑defined fields.
Includes UR1, UR2 resources.
Includes CA‑IDMS subschemas and areas.
Includes IMS PSB and DBD resources.
Includes program resources.
Includes all SMS resources.
Includes terminal resources.
Includes all TSO resources.
Includes all VM resources.
Includes volume resources.
Includes all of the above classes of resources.
If you use CHART(RESOURCE), the default is RESOURCE(ALL); otherwise, the default is RESOURCE(NONE).
Specifies the page size for TSSCHART. This specification is useful for printing charts on non‑standard size pages, because blocks will not cross page boundaries.
This keyword has the following format:
PAGE(nn)
Specifies the page size, which can be from 01 to 99 lines per page. The default value is 66.
The ZONE and XZONE keywords let you specify zones to include (ZONE) or exclude (XZONE) from the chart. XZONE is treated hierarchically. After a zone has been excluded, you cannot report on divisions, departments, users, or profiles that fall within the excluded zone. The acid types that can use this keyword are LSCA, SCA, and MSCA.
This keyword has the following format:
ZONE | XZONE(zone,...,*ALL*,*NONE*,*EJECT*)
Includes or excludes any valid specified zone names.
Includes or excludes all zones.
Includes or excludes no zones.
Causes a page eject at each new zone.
Note: *EJECT* must be the last item in the list or the only item.
The default is ZONE(*ALL*) or XZONE(*NONE*).
The DIV or XDIV keyword specifies divisions to include or exclude from the chart. XDIV is treated hierarchically. After a division has been excluded, you cannot report on departments, users, or profiles that fall within the excluded division. The acid types that can use this keyword are: ZCA, LSCA, SCA, and MSCA.
This keyword has the following format:
DIV | XDIV(div,...,*ALL*,*NONE*,*REG*,*EJECT*)
Includes or excludes any valid specified division names.
Includes or excludes all divisions.
Includes or excludes no divisions.
Includes or excludes those divisions belonging to zones.
Causes a page eject at each new division.
*EJECT* must be the last item in the list or the only item.
The default is DIV(*ALL*) or XDIV(*NONE*).
Example: List ACIDs and Show Records Sizes and Page Ejects
In this example, an MSCA needs a listing of all ACIDs in the Security File as well as resource ownership. In addition, the MSCA wants to know the size of the ACID records on the Security File and page ejects on new divisions.
CHART(ACIDS,RESOURCE,SCA,LSCA,ZCA,VCA,DCA,STATS) DIV(*EJECT*)
Example: List ACIDs, List Record Sizes, and Request Separate Pages for New Divisions
In this example, an SCA only wants a chart of all ACIDs in the Security File accompanied by the record size of the ACID. The entry requests separate pages for each new division.
CHART(ACIDS,STATS) DIV(*EJECT*)
Specifies those departments to include (DEPT) or exclude (XDEPT) from the chart. XDEPT is treated hierarchically. After a department has been excluded, you cannot then report on users or profiles that fall within the excluded department. The acid types that can use this keyword are: VCA, ZCA, LSCA, SCA, and MSCA.
This keyword has the following format:
DEPT | XDEPT(dept,...,*ALL*,*NONE*,*DIV*,*EJECT*)
Includes or excludes any valid specified department names.
Includes or excludes all departments.
Includes or excludes no departments.
Includes or excludes only those departments belonging to divisions.
Causes a page eject at each new department.
Note: *EJECT* must be the last item in the list or the only item.
The default is DEPT(*ALL*) or XDEPT(*NONE*).
The PROF and XPROF keywords specify profiles to include (PROF) or exclude (XPROF) from the chart.
The keyword specification has the following format:
PROF | XPROF(prof,...,*ALL*,*NONE*)
Includes or excludes any valid specified profile names.
Includes or excludes all profiles.
Includes or excludes no profiles.
The default is PROF(*ALL*) or XPROF(*NONE*).
The USER and XUSER keywords specify user‑level ACIDs to include or exclude from the chart.
This keyword has the following format:
USER|XUSER(acid,...,*ALL*,*NONE*,*ONLY*)
Includes or excludes any valid specified user‑level ACID names.
Includes or excludes all users.
Includes or excludes no users.
Shows only USER ACIDs. You can combine this parameter with *ALL* to see all USER ACIDs in the security file. You can also include a list of ACIDs to see specific users. You can use ZONE, DIV, DEPT, and PROF keywords to filter user ACIDs by ZONE, DIV, DEPT, or PROF.
Note: *ONLY* must be the last item in the list or the only item.
The default is USER(*ALL*) or XUSER(*NONE*).
Example: Show Only the SAMPUSER ACID
In this example, an administrator wants to see only the SAMPUSER ACID, including its owned resources and record size. To do, the administrator specifies the following option in the JCL:
CHART(resources,stats) USER(SAMPUSER,*ONLY*)
This specification produces the following output:
+--------------------------------------------------------------+ | ACID: SAMPUSER TYPE: (PROF) | | ACID NAME: SAMPUSER SAMPLE PROFILE | | RESOURCES OWNED: | | TYPE: NAME: | | +--($SAMPRES) PROFRES | +--------------------------------------------------------------+
The LAYOUT keyword specifies the page layout for TSSCHART. This functionality is useful when printing the output of TSSCHART on standard 8½x11inch paper.
This keyword has the following format:
LAYOUT(LS|PO)
Specifies to format output for landscape print on 11x8½ inch paper. When this value is supplied, the default for PAGE is 66.
Specifies to format the output for portrait print on 8½x11inch paper. When this value is supplied, the default for PAGE is 66.
If LAYOUT is not supplied, the default is LAYOUT(PO).
Example: Format Output for Landscape Printing
This example formats output for landscape print on 11x8½ inch paper.
CHART(ACIDS,STATS) LAYOUT(LS)
|
Copyright © 2014 CA Technologies.
All rights reserved.
|
|