IOFTech    Maintenance   Release8G       Newsletters    Doc    FAQ    Contact    Home

IOF Problem Resolution
Problem D02
Previous Next
Description A batch clist or Rexx exec terminates with a "REFUSED" error. (SLAM, JAR, IOFWTR, OUTQUE, IOFLISTG, or local execs and clists)
 
Background The batch TSO session must be authorized to perform the required function. SLAMRUN and SLAMMEMO browse SYSLOG. SLAMWTR browses and cancels a SYSLOG data set. OUTQUE browses the specified jobs and performs the requested action (cancel, route, etc.). IOFWTR selects and modifies or cancels specified output groups.

In most sites, a batch job assumes the same characteristics as the submitter of the job. If the TSO user who submits the job has access to a function, the batch job should have the same access. If the submitter's userid is not automatically given to the batch job, then USER and PASSWORD JOB statement parameters may be required.


 

Solution The JOB or STC must be authorized to perform the specific IOF function.

Started tasks are permitted to do all IOF functions at most sites. If this is a batch job, perhaps it can be changed to run as a started task.


 

Information The distributed B23ALLOW options member defines a started task group, STCGROUP, which is authorized to perform all IOF functions. If you have removed or modified the group macro for STCGROUP, or if you have modified any of the ALLOW macros it references to restrict the access permitted to started tasks, you may have removed the authority for the clist to perform the function it is designed to do. You must grant the task permission to perform the function.

A copy of the distributed B23ALLOW option is included in OPTION data set member Z23ALLOW.


 

Information Started tasks are not automatically assigned a userid. The userid may have to be assigned via the security system (RACF, ACF2 or TSS).


 

Information Most of the distributed clists and execs can be traced by specifying the "TEST" parm.

Local execs can be traced by adding a "TRACE R" statement to the exec. Local clists can be traced by adding a "CONTROL LIST CONLIST" statement to the clist.


 

Information The PAUSE command is used by several IOF batch TSO clists, including SLAMRUN, SLAMPROC, SLAMOPER and IOFWTR. The userid under which these clists is run must be assigned to an IOF GROUP that allows the EVERY and PAUSE commands. See the MINPAUS parm on the IOF GROUP macro description in the B23$DOC member of the IOF OPTIONS library.


 

Information Most of the distributed batch clists and Rexx execs display the value of several IOF variables in the SYSTSPRT output data set. This information may be valuable in debugging the batch problem.

It may be useful to run a simple test clist under the same conditions as the failing clist or exec. The following simple clist will display many IOF variables that may be useful.

Add the following clist to the IOF CLIST library as member TESTDVAR.

PROC 0
IOF * OPTMENU CLIST
%IOF$OP1 ALL
JUMP X

This clist invokes the IOF$OP1 clist to display IOF variables. IOF$OP1 resides in the IOF clist library.

The JCL below can be used to run the TESTDVAR clist.

    //IOFVARS  JOB ... (your job statements)
    //   EXEC  PGM=IKJEFT1B
    //SYSTSPRT DD SYSOUT=*
    //SYSPROC  DD DISP=SHR,DSN=your.iof.CLIST
    //SYSTSIN  DD *
    %TESTDVAR

The SYSTSPRT sysout data set will display the values of the IOF variables. A sample of the SYSTSPRT output is shown below. The userid, IOF group name, group characteristics, and other valuable debugging information is shown.

READY
TESTDVAR
 SESSION Variables Display
 Name-----Value----From--------Option---Description-----------------
 USERID   SYSP91   SESSION              Userid of this session
 ASCBTYPE JOB      SESSION              Job, TSU, or STC
 GRPNAME  OPERATOR SESSION     B23ALLOW IOF Group name
 ACCT     1        SESSION              Account code
 PROC     BATCH    SESSION              Logon Proc
 TERM              SESSION              Terminal name
 XEQSYSID WPK9     SESSION              Execution system id
 INTRFACE BATCH    SESSION              IO interface type
 ACFGROUP OPR001   SESSION              RACF connect group
 JESX     JES2     SESSION              JES2 subsystem name
 A19NODEN RTPTSI   SESSION              Session node name
 A19NODEI RTPTSI   SESSION              Session target node name

SYSTEM Variables Display Name-----Value----From--------Option---Description----------------- IOFLEVEL 8A SESSION IOF level IOFSPIN 2005011 OPTIONS IOF spin level IOFENV TSO SESSION IOF environment JES2LEVL OS280 SESSION C75ASMJS JES2 level MVSLEVEL SP6.0.8 SESSION C75ASMJS MVS level MVSFMID HBB6608 SESSION C75ASMJS MVS FMID MVSCHAR POUND OPTIONS B49CMPAT MVS command character INPRUN NO OPTIONS B49CMPAT Show running with input STMOPTDS IOF.IOFT8A0.OPTIONS IOF OPTIONS data set name

MISC Variables Display Name-----Value----From--------Option---Description----------------- DFLRESET YES OPTIONS B48RESET Reset option menu variables STMWUNIT SYSDA OPTIONS C20XUNIT System work device unit type SIPREFIX SYSIOF OPTIONS B32INDEX Default index DSN prefix SISUFFIX IOFINDEX OPTIONS B32INDEX Default index DSN suffix SLMSYSID YES OPTIONS B30SLAM Sysid in SLAM index DSN SLMEMOJN SLAMMEMO OPTIONS B30SLAM SLAMMEMO jobname SLMJOBNM SYSLOG OPTIONS B30SLAM Name of the SYSLOG task SLMINDEX YES OPTIONS B30SLAM SYSLOG index exists GDMLIB XXXXX PROFILE setpvar GDDM load library DSN " " NONE OPTIONS B59GDDM " " GDMSYM NONE OPTIONS B59GDDM GDDM symbol library DSN BKMCLIST BOOKMGR OPTIONS B66BOOKM BookManager Rexx exec name BKMSHELF NONE OPTIONS B66BOOKM BookManager messages shelf name

GROUP Variables Display Name-----Value----From--------Option---Description----------------- UADSOPER YES SESSION B23ALLOW Operator authority UADSACCT NO SESSION B23ALLOW Account authority UADSJCL YES SESSION B23ALLOW Submit authority UADSMNT NO SESSION B23ALLOW Mount authority GRPNAME OPERATOR SESSION B23ALLOW Group name GRPPANEL OPTOPT SESSION yes B23ALLOW IOF Option Menu name GRPICMD INITCMD SESSION yes B23ALLOW Initial command GRPPAUSE 0 SESSION B23ALLOW Minimum pause GRPCMD31 NO SESSION B23ALLOW Command type 31 GRPCMD32 NO SESSION B23ALLOW Command type 32 GRPEXTND YES SESSION B23ALLOW Extend option GRPFINDD 0 SESSION B23ALLOW Findlim default GRPFINDM 0 SESSION B23ALLOW Findlim maximum

GROUP2 Variables Display Name-----Value----From--------Option---Description----------------- GRPSYSID NONE SESSION B23ALLOW Default log systemid GRPDSCOP USER SESSION B23ALLOW Default scope GRPMSCOP ALL SESSION B23ALLOW Maximum scope GRPDISP1 150 SESSION B23ALLOW Minimum display update time GRPDISP2 5 SESSION B23ALLOW Minimum display redisplay GRPEXTSO NO PROFILE setpvar Exclude TSO session " " YES SESSION B23ALLOW " " GRPCNS OPTIONS B23ALLOW Error 10525 retrieving variable GRPDRCMD YES SESSION B23ALLOW DR command allowed GRPINP YES SESSION B23ALLOW GROUP INPCMD parm GRPQOPT YES SESSION B23ALLOW GROUP QOPT parm GRPACTN YES SESSION B23ALLOW GROUP ACTION parm

JAR Variables Display Name-----Value----From--------Option---Description----------------- USERID SYSP91 SESSION Userid of this session GRPNAME OPERATOR SESSION B23ALLOW IOF Group name ASCBTYPE JOB SESSION Job, TSU, or STC XEQSYSID WPK9 SESSION Execution system id INTRFACE BATCH SESSION IO interface type JRPREFIX SYSP91 PROFILE setpvar JAR DSN prefixes " " SYSIOF OPTIONS B34OFFLD " " JRSUFFIX OFFRUN OPTIONS B34OFFLD JAR DSN suffixes JRSERVER NO OPTIONS B34OFFLD Use server to upload JRSOCLS A OPTIONS B34OFFLD JAR report sysout class JROFFNR 1 OPTIONS B34OFFLD JAR offloader number JRWTRID IOFUPLOD OPTIONS B34OFFLD JAR upload writer id ACFGROUP OPR001 SESSION RACF connect group A19NODEN RTPTSI SESSION Session node name IOFLEVEL 8A SESSION IOF level IOFSPIN 2005018 OPTIONS IOF spin level SIPREFIX SYSIOF OPTIONS B32INDEX Default index DSN prefix SISUFFIX IOFINDEX OPTIONS B32INDEX Default index DSN suffix GRPPAUSE 0 SESSION B23ALLOW Minimum pause GRPEXTND YES SESSION B23ALLOW Extend option

ACF Variables Display Name-----Value----From--------Option---Description----------------- ACFTYPE RACF PROFILE setpvar Type of security system " " RACF OPTIONS A60ACF " " ACFPREFX SYSP91 OPTIONS B24ACFDF ACF profile prefix ACFCLASS DATASET OPTIONS B24ACFDF ACF class ACFGLOBL YES OPTIONS A60ACF Old ACF GLOBAL parm ACFUSER YES OPTIONS A60ACF Old ACF USER parm ACFAL1 ALLOW 4,4,JOBS,JOBCOMBO,ACF=GLOBAL ACFAL2 ALLOW 4,4,GROUPS,DEST,ACF=GLOBAL ACFAL3 ALLOW 4,4,DEVICES,DEVCOMBO,ACF=GLOBAL ACFAL4 ALLOW 4,4,COMMANDS,CMDCOMBO,ACF=GLOBAL ACFAL5 ALLOW 4,4,SYSTEMS,SYSID,ACF=GLOBAL

READY END


 
More Help Click here to EMAIL a problem report to IOF Technical Support for additional assistance.

 

Previous Next

Triangle Systems, Inc. PO Box 12752, Research Triangle Park, NC 27709
(919) 544-0090

IOFTech    Maintenance   Release8G       Newsletters    Doc    FAQ    Contact    Home

Monday, 25-Jan-2016 13:45:33 EST
[an error occurred while processing this directive]

npause iofop @@