Fundamentals of TSO

7/31/2019 Fundamentals of TSO

1/84

Instruction,ResearchandInfrastructureSupport,ArizonaStateUniversity

IBMMainframeJuly2002

FundamentalsofTSO

TableofContents

1.INTRODUCTION.................................................................................................11.1Abstract....................................................................................................11.2GeneralInformation................................................................................12.OVERVIEW...........................................................................................................12.1MajorComponents..................................................................................12.2TypicalTerminalSession........................................................................23.ACCESSINGTHESYSTEM.................................................................................33.1SystemSelection......................................................................................3

3.2TSOLogon................................................................................................43.3TSOLogoff...............................................................................................64.DATASETS...........................................................................................................74.1DataSetNamingConventions...............................................................74.2DataSetFormats......................................................................................104.3UnpressWYLBURDataSets..................................................................105.ISPF(MenuFacility)........................................................

.....................................115.1Overview....................................................................

..............................115.2TerminalKeys..........................................................................................135.3PFKeyList...............................................................................................135.4PFKeyValues..........................................................................................145.5HelpKey...................................................................................................145.6TechnicalNotes........................................................................................14

6.EDITOR..................................................................................................................157.BATCHJOBJCL....................................................................................................187.1JOBStatement..........................................................................................197.1.1PositionalParameters...............................................................197.1.2KeywordParameters................................................................20


2/84

7.2ROUTEStatement....................................................................................217.3JOBPARMStatement...............................................................................217.4TAPESStatement.....................................................................................227.5OUTPUTStatement.................................................................................227.6JCLLIBStatement....................................................................................228.BATCHJOBSUBMITTAL...................................................................................228.1SPF/PDFSUBMITCommand................................................................238.2TSOSUBMITCommand.........................................................................239.IOF(FetchingBatchJobOutput).........................................................................249.1InvokingIOF............................................................................................259.2On-lineHelpandTutorial......................................................................259.3RunningJobs(BatchJobs).......................................................................26

9.4InputJobs(BatchJobs)............................................................................269.5OutputJobs(PrintJobs)..........................................................................26MVS-i-TSO


3/84

FundamentalsofTSO

TableofContents

9.6HeldOutput.............................................................................................27

9.7SaveBatchOutputtoDisk......................................................................27

10.RACF(DiskandTapeSecurity).........................................................................28

10.1ProfileNames.........................................................................................28

10.2DiskFileSecurity...................................................................................29

10.3TapeVolumeSecurity...........................................................................29

10.4LISTUSER...............................................................................................29

10.4.1DisplayDiskQuota.................................................................30

10.4.2DisplayAccountNumber......................................................30

10.5ALTUSER...............................................................................................30

11.TSOCOMMANDS..............................................................................................31

11.1ALLOCATE...................................................................

.........................31

11.2CALL......................................................................................................32

11.3DELETE..................................................................................................33


4/84

11.4EXEC.......................................................................................................33

11.4.1ExplicitExecs...........................................................................33

11.4.2ImplicitExecs...........................................................................34

11.5EXECUTIL..............................................................................................35

11.6FREE.......................................................................................................35

11.7FTP..........................................................................................................35

11.8HELP.......................................................................................................36

11.9IOF..........................................................................................................36

11.10ISPF.......................................................................................................36

11.11ISRDDN................................................................................................36

11.12LINK.....................................................................................................37

11.13LISTALC...............................................................................................37

11.14LISTCAT...................................................................

............................37

11.15LISTDS..................................................................................................38

11.16LOADGO..............................................................................................38


5/84


6/84

Instruction,ResearchandInfrastructureSupport,ArizonaStateUniversity

IBMMainframeJuly2002

FundamentalsofTSO

1.INTRODUCTION1.1AbstractTSO(TimeSharingOption)providesaninteractiveenvironmentontheAcademicIBMMVSsystemforprogramexecution(interactiveandbatch),editing,printing,andmanagingdata.Muchofitsfunctionalityisprovidedbymenu-drivenfull-screenutilities.ThisdocumentdescribeshowtouseTSOanditsmajorcomponents.

1.2GeneralInformationInformationregardingIOF,JCL,printing,diskquotas,andtheurlforonlinehelphasbeenupdated.

2.OVERVIEWTSOisavailableontheAcademicIBMMVSsystem.Accessismadeviaatn3270telnet

session.("tn3270"isagenericreferencetoa3270-typeterminalemulator.Thestandardtelnetprogramusuallydoesnotemulatethisterminaltype.Aspecialtelnetprogramwhichemulatesaterminalinthe327xfamily(andwhichoftenhas"3270"initsname)isneeded.)

Note:Thesamemethods,software,useridsandpasswordsformerlyusedtoaccessfull-screenWYLBURareusedtoaccessTSO.

TSOisfairlysimpletouse.Asystemofmenusisprovidedfromwhichyouselect

thetaskstobeaccomplished.Thesetasksincludeusingtheeditor,submittingandmonitoringbatchjobs,interactiveprogramexecution,printing,andmanagingfiles.ThenamesofthemajorcomponentswhichprovidetheseservicesareISPF(themenusystem),SPF/PDF(theeditor),IOF(batchjobmonitor),andRACF(accountattributesandsecurity).

2.1MajorComponentsISPF(InteractiveSystemProductivityFacility)isamenu-drivenshellwhichsimplifiesTSOusageandprovidesnumerousutilityfunctions.Theutilityfunctionsinclude

creating,editing,deleting,printing,andrenamingfiles,andlookingatfiles,filedirectories,andcatalogentries.ISPFisalsousedasaninterfacetoaccessothersoftware

MVS-1-TSO


7/84

FundamentalsofTSO

onthesystemandoftenisrequiredforinteractiveexecution.ISPFistypicallyaccessedbyenteringthecommandISPF.

SPF/PDF(ProgramDevelopmentFacility)isafull-screeninteractivetexteditor.Itcanalsobeusedtosubmitbatchjobs.TheeditoristypicallyaccessedfromISPFutilities/dslistmenu,butcanalsobeaccessedfromtheISPFprimarymenu.

IOF(InteractiveOutputFacility)isafull-screeninteractiveutilityformonitoringbatchjobs,viewingbatchjoboutput,andpurgingorprintingbatchjoboutput.IOFistypicallyaccessedfromtheISPFprimarymenu.

RACF(ResourceAccessControlFacility)controlsdiskandtapefilesecurity,keepstrackofyourdiskspacequota,defaultprinterdestination,logonpassword,andseveralotheraccountrelatedattributes.RACFistypicallyaccessedfromtheISPFprimary

menu.

2.2TypicalTerminalSessionThetypicalsessionbeginswithatn3270telnetconnectionusingtheaddress"acmvs.inre.asu.edu".AssoonasthecommunicationslinkwiththeIBMsystemisestablished,aVTAMSystemSelectionscreendisplaysalistofsystemsandsub-systemsavailableforlogon.SelectAcademicTSOtostartthelogonprocess.

Thereafter,youarepromptedforauseridandthenforalogonpasswordandotheroptionalinformation.OneofoptionalitemsyoucandesignateisaTSOcommandtobe

automaticallyexecutedaspartofthelogonprocess.SomepeopleentertheISPFcommandtostartupISPFimmediatelyuponlogon;othersusetheEXECcommandtoexecuteaprogramorexec(typicallyinREXX)tocustomizetheirlogonprocess.

Ifyoulogonwithoutenteringanoptionalcommand,youareplacedinTSOnativemode,easilyidentifiablebyaREADYprompt.WhileinTSOmode,youcanenteranyTSOcommand.MostpeopleenterthecommandISPFtoactivatethemenu-drivenfull-screenfacilities.WhileitisnotnecessarytoactivateISPFbeforedoingusefulwork,somesoftwarerequireISPFtobeactiveforproperfunctioning.Inparticular,thefull-

screentexteditorPDFisnotavailableunlessISPFisactive.

AfterISPFisactive,theprimaryISPFmenuisdisplayed.YoucanselecttheEDIToptionontheprimarymenu(orintheUTILITIES/DSLIST)optiontoeditfilesandtosubmitbatchjobs.UsetheUTILITIESoptiontocreate,edit,delete,rename,andprintfiles.UsetheIOFoptiontomonitorbatchjobs.UsetheEXIToptiontoexitISPFand


8/84

returntonativeTSOmode.(YoumustexitISPFbeforetheLOGOFFcommandwillfunction.)

ToselectanISPFoption,typetheoption'scorrespondingidentifier(aletter,number,orword)ontheISPFcommandlineandpressENTER.Someoptionscauseothermenus

MVS-2-TSO


9/84

FundamentalsofTSO

toappearwhichoperateinthesamefashionastheprimarymenu.Someofthemenusmaycontainfieldsinwhichyouneedtotypevalues,suchasadatasetname,beforeproceeding.Asageneralrule,afteryou'veselectedtheappropriateoptionsandhavecompletedthedesiredtasks,youcanreturntotheprimaryISPFmenubypressingthePF3keyoneormoretimes.

ToexitISPFandreturntonativeTSOmode,selecttheXoptionontheprimaryISPFscreenorenterthecommand=XfromotherISPFscreens.Afteryou'vereturnedtonativeTSO,youcanenterotherTSOcommands,re-enterISPF,orlogoff.

3.ACCESSINGTHESYSTEM3.1SystemSelectionWelcometoASUComputingServices

*ThissystemisonlyforuseauthorizedbyASU*

STATUS

1.HELP2.ScheduledServiceInterruptions4.VM/CMS-InformationCenter(NodeASUACAD)ACTIVE8.AcademicTSO(NodeACADMVS)ACTIVE12.NextMenuRequest===>Enter1-12orPressPF1-PF12key

ThisisasampleSystemSelectionscreen.Theactualscreentowhichyouhaveaccessmaydiffersubstantiallyfromthatshownabove;however,theformatwillbesimilar.

ToselecttheAcademicTSOsystem:

??DeterminewhichitemonthescreencorrespondstoAcademicTSO(inthissample,8).??Typethecorrespondingnumber(8inthissample)intheinputfieldafterthe'===>'nearthebottomofthescreen,thenpressENTER.

AfterAcademicTSOhasbeensuccessfullyselected,thefollowingpromptwillappear:

IKJ56700AENTERUSERID

TypeyouruseridinresponsetothispromptandthenpressENTER.Thesystemwillsubsequentlypromptforalogonpassword(andotheroptionalinformation)ontheTSOLogonscreen.

MVS-3-TSO


10/84


11/84

FundamentalsofTSO

3.2TSOLogon-------------------------TSO/ELOGON---------------------------ENTERLOGONPARAMETERSBELOW:RACFLOGONPARAMETERS:USERID===>ABCDEPASSWORD===>NEWPASSWORD===>PROCEDURE===>ISPFPDFSGROUPIDENT===>ACCTNMBR===>12345SIZE===>4096PERFORM===>COMMAND===>

ENTERAN'S'BEFOREEACHOPTIONDESIREDBELOW:S-NOMAILS-NONOTICE-RECONNECT-OIDCARDPF1==>HelpPF3==>LogoffPA1==>AttentionPA2==>Reshow

YourequestspecificHELPbyenteringa'?'inanyentryfield.

ThisisasampleTSOLogonscreen.Theactualscreentowhichyouhaveaccessma

ydifferandmayhavedifferentvaluesforthevariousfields;however,theformatwillbesimilar.

ThesampleillustratespossiblelogonvaluesforuseridABCDE.Thevaluesdisplayedarethosewhichweresetwhentheaccountwasestablishedorwhichtheowneroftheuseridsetduringapreviouslogon.(HELPinformationforanyinputfieldmaybeobtainedbytyping?intheinputfieldandpressingENTER.YoumayalsorequesthelpbypressingthePF1key.)

Youmaytypeoneormorevaluesonthisscreen.UsetheTABkey(nottheENTERkey)tomovefromonefieldtoanother.UsetheENTERkeyafteryou'vefilledintherelevantfields.

Asageneralrule,youonlyneedtotypeyourlogonpasswordinthePASSWORDfieldandpressENTER.Thefirsttimeyoulogon,typeISPFintheCOMMANDfieldbeforepressingENTER.(Ifyouareusingaself-containedapplicationsuchasSAS,youmaywanttoenteracommandtostartSASinstead.)Ifit'salsothefirsttimeyou'veusedtheMVSs

ystem,typeanewlogonpasswordintheNEWPASSWORDfield.(Pleaserememberyournewpassword;youneedittologonnexttime.)

TheUSERIDfieldcontainstheuseridyouenteredinresponsetoalogonpromptonapreviousscreen.Iftheuseridisincorrect,pressthePF3keytorestartthelogonprocess.

MVS-4-TSO


12/84


13/84

FundamentalsofTSO

Ifthedisplayeduseridiscorrect,typethelogonpasswordinthePASSWORDfield.Thepasswordwillbeinvisible.

TheNEWPASSWORDfieldisusedtochangeyourlogonpassword.Donottypeanythinginthisfieldforanyotherpurpose.Thenewpasswordwillbeinvisible.Newpasswordshaveaminimumsizeof6characters,amaximumof8;containuppercasealphabeticcharacters(A...Z),digits(0...9),andnationalcharacters($#@);andcannotbeidenticaltooneoftherecentlyusedlogonpasswords.YouarerequiredtochangeyourpasswordthefirsttimeyouusetheMVSsystemandperiodicallythereafter.Thesystemwillpromptyoutoenteranewpasswordwhennecessary.

CAUTION:TYPEYOURNEWPASSWORDCAREFULLYandREMEMBERIT.Ifyouincorrectlytypethenewpasswordorforgetit,youwillnotbeabletodofuturelogons.Intheeventyouareunabletodeterminethepasswordfortheuserid,contacttheComputer

AccountsOffice.

ThestandardvalueforPROCEDUREontheAcademicTSOsystemisISPFPDFS.Thiscannotbechangedunlesstheuseridisauthorizedforotherprocedures.Theprocedureallocatesthestandardfilesnecessaryforinteractiveuseofthevarioussoftwarepackages.Youcancustomizethelogonprocedure,toallocateotherfilesortoperformotherfunctions,bytypinganEXECcommandintheCOMMANDfield(describedbelow).

ThestandardvalueforACCTNMBRistheuserid'saccountnumber.Thiscannotbechangedunlesstheuseridisauthorizedforotheraccountnumbers.

ThestandardvalueforSIZEis4096,whichrequests4MBofvirtualmemoryforyourTSOterminalsession.Eachmultipleof1024represents1MB.Ifthevalueissmallerorlargerthanyourneeds,typeanewvalue.Thisfieldcannotbechangedtoavaluegreaterthantheuserid'smaximumforaninteractivesession.Alluseridsaresetupwithamaximumof32MBforinteractiveprocessing.Batchjobscanbeusedtorun

programswhichhavelargermemoryrequirements.

TheCOMMANDfieldisusedtoexecuteasingleTSOcommandaspartofthelogonprocess.LeavethefieldblanktobeginyourterminalsessioninnativeTSOmode.Tobegininfull-screenISPFmode,typeISPFinthefieldTocustomizethelogonprocess,typeanEXECcommandintheCOMMANDfieldtoexecuteanexecyou'vewrittenineitherREXX(recommended)orCLIST;theexecmaycontainotherTSOcommandsandmayexecuteotherexecsandprograms.Toimmediatelyinvokeanapplication(for


14/84

exampleSAS)withoutgoingintonativeTSOorISPFmode,typethecommandwhichinvokestheapplication.

ThePERFORM,GROUPIDENT,andOIDCARDfieldsshouldbeblank.Thesefieldscannotbechangedunlesstheuseridisauthorizedforothervalues.

TheNOMAILandNONOTICEfieldsshouldbeStodisallowmessagereceptionduringlogonorshouldbeblanktoallowreceiptofmessagesduringlogon.Possible

MVS-5-TSO


15/84

FundamentalsofTSO

messagesthatmaybereceivedincludenotificationoffiletransferandnotificationofbatchjobcompletion.Itisrecommendedthatyouperiodicallyputblanksinthesetwofields.

TheRECONNECTfieldshouldbeblankunlessyouaretryingtoreconnecttoadisconnectedsession,inwhichcasetypeSinthefield.Adisconnectedsessionisautomaticallyloggedoffafterafewminutes,unlessyoureconnectbeforethelogoffoccurs.(ThereisnoTSOequivalentofaVM/CMSdisconnectedsessionwhichallowsaprogramtocontinueexecutionafterdisconnection.Ifyouhavealongrunningprogramoraprogramwhichrequiresmanyresources,youshouldexecuteitasabatchjob.)

Afterallrelevantfieldshavebeenupdated,pressENTER.Variousinformationalmessagesmayappearbeforethelogonprocesscompletes.Ifanylinesconsistingof

severalasterisksappear,pressENTERtocontinuetheprocess.

3.3TSOLogoffNativeTSOMode

IfyourterminalsessionisinnativeTSOmode(identifiablebytheREADYprompt),enterthefollowingcommandtologoff:

LOGOFF

ItisalsopossibletologoffoneuseridandsimultaneouslybegintheTSOlogonprocess

foranotheruserid.Thisisdonebyenteringthefollowingcommand,wherenewuseridrepresentstheuseridtobeusedforthelogonprocess:

LOGONnewuserid

ISPFMode

IfyouareusingISPF,returntonativeTSOmodebyexitingISPF.AfterexitingISPF,followthelogoffinstructionsshownaboveforNativeTSOMode.AbriefsummaryonhowtoexitISPFisgivenbelow:

??IftheprimaryISPFmenuisnotdisplayed,returntotheprimaryISPFmenu.ThisistypicallyaccomplishedbypressingthePF3keyrepeatedly.??OncetheprimaryISPFmenuisdisplayed,typeXonthecommandlineandpressENTER.

??Dependingoncircumstances,eithertheREADYpromptappears(nativeTSOmode)oranISPFscreenrequestingthedispositionoftheLOGand/orLISTdatasetsisdisplayed.


16/84

??IftheISPFLOG/LISTdispositionscreenisdisplayed,entertheappropriateinformationtoeitherprintordeletetheLOGorLISTfilesandthenpress

MVS-6-TSO


17/84

FundamentalsofTSO

ENTER.AbatchjobissubmittedtoprintthefilesandthenISPFexits.(MoreinformationonLOG/LISTisgivenlaterinthisdocument.)??Atthispoint,nativeTSOmodewillbeactive.RefertothelogoffinstructionsshownaboveforNativeTSOMode.

4.DATASETS4.1DataSetNamingConventionsSeveraldatasetnamingconventionsareusedontheMVSsystematASU,thetwomostcommonbeingTSOandWYLBUR.TheseconventionsaresubsetsofthestandardIBMMVSdatasetnamingconvention.Permanentdatasetswhichyoucreatemustcomplywithanappropriatenamingconvention.

BecausethenamingconventionforTSOisdifferentthantheoneusedforWYLBUR,peopleoftenask:CanIusemyWYLBURdatasetsfromTSO?

TheanswerisYES.FromTSOyoucanusedatasetsontheMVSsystemregardlessofthenamingconvention;however,certainTSOtasksaresimplerwhenthedataset

sbeingreferencedconformtotheTSOnamingconvention.SomeTSOfunctionsrequirepriordecompressionofdatasetsinWYLBUReditformat.

Severalnamingconventionsaredescribedbelow,beginningwiththestandardIBMdatasetnamingconvention.Fordatasetsyoucreate,theTSOnamingconventionisrecommended;however,youmayfindtheWYLBURnamingconventionmoreconvenientifyouhaveotherfileswhichconformtotheWYLBURconvention.

StandardIBMNamingConvention

-Adatasetnameconsistsofoneormorewordscalledqualifiers.

-Eachqualifierconsistsof1to8alphabetic,numeric,and/ornationalcharacters.(Thealphabeticcharactersaretheuppercaseletters(A...Z);thenumericcharactersarethedigits(0...9);thenationalcharactersarethedollar,pound,andcommercialatsigns($#@).

-Thefirstcharacterofeachqualifiermustbeeitheralphabeticornational.-Aperiod(.)isusedasaseparatorbetweenqualifiers.-Theoveralllengthofthedatasetname,includingperiods,cannotexceed44characters.-Amembernameenclosedinparenthesesmaybeappendedtothenameofapartitioneddataset

ifamemberofthedatasetisbeingreferenced.Themembernameconsistsofaonewordqualifier.Themembernameandtheenclosingparenthesesdonotcounttowardthe44characterlengthofthedatasetname.

MVS-7-TSO


18/84


19/84

FundamentalsofTSO

TSONamingConvention

-TheStandardIBMNamingConventionandtheconditionslistedbelowareused.

-Thedatasetnamemusthaveatleasttwoqualifiers.(Ifithasexactlythreequalifiers,italsoconformstotheISPFNamingConvention.)

-Thefirstqualifiermustbetheuseridofthedatasetowner.

-ForVSAMfilesonly,theCLUSTER,DATA,and(ifpresent)INDEXcomponentsmustexplicitlybegivennames.

ISPFNamingConvention

-TheTSONamingConventionisused,exceptthedatasetnamemusthaveexactlythreequalifiers.

WYLBURNamingConvention

-TheStandardIBMNamingConventionandtheconditionslistedbelowareused,exceptthe

nationalcharacters($#@)shouldnotbeusedinthedatasetnamenorinthemembername.

-Thedatasetnamesmusthaveatleastfourqualifiers.

-ThefirstqualifiermustbeWYLorVSM.WYLisusedfornon-VSAMfiles,andVSMisusedforVSAMfiles.(Thedistinctionbetweenthetwotypesoffilesfornamingpurposesisnolongerrequired.)

-Thesecondqualifiermustbethefirsttwocharactersoftheuseridwhichownsthedataset.

-Thethirdqualifiermustbethelastthreecharactersoftheuseridwhichownsthedataset.

-Afourthqualifierisrequired;additionalqualifiersbeyondthefourthareoptional.

-TheformerWYLBURenvironmentpermitteddatasetnamequalifierstohavemorethan8charactersandtohavenon-standardcharacters.Non-standarddatasetnamesmaycreatedifficultiesinotherenvironments.

-ForVSAMfilesonly,theCLUSTER,DATA,and(ifpresent)INDEXcomponentsmust

explicitlybegivennames.

-AmembernamefollowsthesamerulesaslistedforStandardIBMNamingConvention,exceptthatothercharactersarealsoallowed;however,theseothercharactersarenotrecommendedifthemembernameistobereferencedinanon-WYLBURenvironment.TheformerWYLBURenvironmentpermittedtwomethodsofdesignatingamembername:enclosingthemembernameinparenthesesorprecedingthemembernamewithapoundsign(#);thelatterisvalid


20/84

onlyinaWYLBURenvironment.

MVS-8-TSO


21/84

FundamentalsofTSO

Sampledatasetnamesareshownbelowforeachnamingconvention.TheuseridABCDEisusedforthoserequiringauserid.

DataSetNameNamingconvention

SYS1.PROCLIB(FORV2CLG)StandardIBMSYS2.WYL.PUB.LIBStandardIBMABCDE.CNTL(JCL)TSOABCDE.SURVEY.PIMA.Y90M03TSOABCDE.RURAL.COUNTYTSOandISPFABCDE.SAMPLE.DATA(PROJ2)TSOandISPFWYL.AB.CDE.LIB(LOGON)WYLBUR(non-VSAM)WYL.AB.CDE.PROJ5.FORTRANWYLBUR(non-VSAM)VSM.AB.CDE.HMWK5.INDEXWYLBUR(VSAM)

Inabatchenvironment(i.e.,inJCLstatements),datasetsarereferencedbyfullyqualifiednames;thatis,thefullnameofthedatasetisused.Ifasinglememberofapartitioneddatasetisbeingreferenced,thefullnameofthedatasetappendedwiththe

membernameenclosedinparenthesesmustbeused.

IntheTSOandWYLBURenvironments,undersomeconditions,anabbreviatedformofdatasetnamesispermitted.Itisalwayspermissibletousefullyqualifieddatasetnames.ThetablebelowillustratesvariouspossibilitiesforreferencingdatasetnamesfromtheTSO,WYLBUR,andbatchenvironments.

FullyqualifieddatasetnameReferencedfromReferencedasABCDE.BOTANY.PROJECTbatchJCLABCDE.BOTANY.PROJECTTSO'ABCDE.BOTANY.PROJECT'BOTANY.PROJECT

WYLBUR'ABCDE.BOTANY.PROJECT'"ABCDE.BOTANY.PROJECT"$ABCDE.BOTANY.PROJECTWYL.AB.CDE.SURVEY.DATAbatchJCLWYL.AB.CDE.SURVEY.DATATSO'WYL.AB.CDE.SURVEY.DATA'WYLBURWYL.AB.CDE.SURVEY.DATA'WYL.AB.CDE.SURVEY.DATA'"WYL.AB.CDE.SURVEY.DATA"$WYL.AB.CDE.SURVEY.DATASURVEY.DATA

Thoughnotshownabove,amembernamemaybespecifiedforpartitioneddatasets,

e.g.,'WYL.AB.CDE.DATA(PROJ3)'andSAMPLE.FORTRAN(MEAN).

Note:Adatasethasonlyonename.TherecannotbeaTSOnameforadatasetandaWYLBURnameforthesamedataset.InTSO,aWYLBURdatasetnamemustalways

MVS-9-TSO


22/84

FundamentalsofTSO

befullyspecifiedandenclosedinsinglequotes.ATSOdatasetnameisenclosedinquotesonlyifitisfullyspecified;otherwise,theTSOdatasetnameisnotquotedandtheleadingqualifier(theuserid)isomitted.

4.2DataSetFormatsTherecordformatofadataset(RECFM)istheprimaryindicatorofthedatasettype.Thelogicalrecordlength(LRECL)andblocksize(BLKSIZE)alsohelpindeterminingdatasettype.TSOcangenerallyworkwithdatasetshavingfixedformat(RECFMofF,FB,FBA,etc.)orvariableformat(RECFMofV,VB,VBA,etc.).PartitioneddatasetshavingaRECFMofUandaLRECLof0areusuallyloadmodules(binary,executableformofaprogram)andarecompatiblewithTSO.PartitionedorsequentialdatasetshavingaRECFMofU,aBLKSIZEof(usually)6233or7476,andanLRECLequaltothe

BLKSIZE(butsometimes0)maybeWYLBUReditformatfiles(compressedfilesreadableonlybyWYLBUR).

DatasetsinWYLBUReditformathavetobeconvertedtofixedorvariableformatbeforetheycanberead,written,edited,orsubmittedasbatchjobsfromTSO.TheinteractiveTSOutility%UNPRESSperformstheconversion.

4.3UnpressWYLBURDataSetsTechnically,thereisnosuchthingasa"WYLBURdataset";thistermnormallyreferstoadatasetwhichconformstotheWYLBURdatasetnamingconvention.

IfadatasetisnotinWYLBUReditformat,nospecialactionisneeded,thoughyoumaywanttorenamethedatasettoconformwiththeTSOnamingconvention.TSOandISPFhavecommandstorenamedatasetsandmembers.

TheTSOcommandforrenamingadatasetfromtheWYBURnamingconventiontotheTSOnamingconventionisshownbelow.(OntheISPFmenuforrenaming,whichisnotshown,yousimplytypethenewnameovertheexistingname.)

RENAME'WYL.AB.CDE.DATA1'DATA1

TheTSOcommandforrenamingamemberofapartitioneddatasetisshownbelow.(OntheISPFmenuforrenaming,whichisnotshown,yousimplytypethenewnamenexttoexistingname.)

RENAMEDATA1(OLD)DATA1(NEW)

IfadatasetisinWYLBUReditformat,theTSOutility%UNPRESSmaybeusedtoconvertthedataset.TheeasiestmethodistouseISPFoption3.4todisplayth


23/84

elistofWYLBURdatasetnames.Oncethelistisdisplayed,pressPF11oneormoretimesuntil

MVS-10-TSO


24/84

FundamentalsofTSO

thescreenwithatitlelineof"DsorgRecfmLreclBlksz"isdisplayed.UsePF7orPF8tomovethescreenupordowntoseeotherdatasetnames.ARecfmofUandaDsorgofPO(partitioned)orPS(sequential)indicatesapossibleWYLBUReditformatdataset.(Loadmodulelibrariescontainbinaryexecutableprograms,haveaRecfmofUandaDsorgofPObutarenotWYLBUReditformat.)(Note:Noharmisdoneifyoutrytoconvertaloadmodulelibraryorothernon-editformatdataset.)

Tabtothelinecontainingthenameofthedatasetyouwanttoconvert,andtype%UNPRESStotheleftofthenameandpressenter.Theconversionprocesstakesseveralsecondstocompleteforasmallfile,longerforlargerfiles.

Youcanalsouse%UNPRESSfromaTSOcommandline.AsampleTSOcommandforconvertinganeditformatdatasetisshownbelow:

%UNPRESS'WYL.AB.CDE.LIB'

Note:SomeearlierversionsofWYLBURwereunabletopreventyoufromsavinganon-editformatmemberintoaneditformatlibrary.Thenewmember(andonrareoccasionstheentirelibrary)wouldbecomeunusable.UNPRESSisunabletodecompresslibrarieswithsuchmembers;however,iftheoffendingmembersaredeleted,UNPRESSwillbesuccessful.

5.ISPF(MenuFacility)5.1OverviewISPF(InteractiveSystemProductivityFacility)isashellwhichprovidesaseriesofmenustosimplifytheuseofTSOandprovidesadditionalfunctionality.Onlyabrief

descriptionofISPFisgiveninthisdocument.

ToactivateISPF,typethefollowingcommandontheTSOcommandline:

ISPF

OnceISPFhasbeenstarted,amenu(alsocalledapanel)isdisplayed.AsampleprimarymenuforISPFisshownbelow:

MVS-11-TSO


25/84

FundamentalsofTSO

ISPF/PDFPRIMARYOPTIONMENU

OPTION===>

0ISPFPARMS-Specifyterminalanduserparameters

1BROWSE-Displaysourcedataoroutputlistings

2EDIT-Createorchangesourcedata

3UTILITIES-Performutilityfunctions

6COMMAND-EnterTSOcommandorCLIST

9IBMSOFTWARE-AdditionalIBMsoftware

DDATASETMGMT-Disk/TapeManagement,FileTransfer

IIOF-InteractiveOutputFacility

TTUTORIAL-DisplayinformationaboutISPF/PDF

XEXIT-TerminateISPFusinglogandlistdefaults

EnterENDcommandtoterminateISPF.

Thepanelsareusedtoidentifythetaskyouwishtoperform.Amenupanelhasalistofoptions,eachprecededbyanidentifier.Toselectanoptiononamenu,typethecorrespondingidentifier(forexample:3,9,orX)ontheOPTIONlineandpressENTER.SomepanelshaveaCOMMANDlineinsteadofanOPTIONline.(TheOPTIONorCOMMANDlinecanbeatthetoporthebottomofapanel.)Thistypically

resultsinanotherpanelbeingdisplayed.Thesubsequentpanelmaycontainanothermenu,oritmaycontainoneormorefieldsinwhichyouneedtoenterrequiredinformation.Forexample,ifoption2(EDIT)werechosen,thesubsequentscreenwouldcontaininputfieldswhereyouwouldtypethenameofthedatasettobeedited.

Note:TheidentifierassociatedwithaparticularitemonaspecificmenumaychangewheneverISPForitsassociatedmenusareupdated,especiallyifnewfeaturesoroptionsareadded.

Selectionofoptionsfromthemainmenucanalsobemadebytypingn.m,wherenisthemainmenuoptionandmisthesubmenuoption.Inthismanneryoucanmovedirectlytomenumwithouthavingtofirstselectnandthenm.Forexample,ifthemainmenuisnotcurrentlydisplayed,butyouwanttoselect3fromthemainmenuand4fromthesubmenu,type=3.4.Theequalsign(=)causesajumptothemainmenuwithoutdisplayingthemenubeforeprocessingtheindicatedoption.


26/84

YoucanusuallyreturntoapreviousmenubypressingthePF3keyortypingtheENDcommand.PressingthePF4keyortypingtheRETURNcommandwillgenerallyreturnyoutothemainmenu.

WhenISPFpanelsaredisplayed,youmaynoticedatafieldscontainvaluesenteredinpreviousISPFsessions.Insomeinstancesyoumaynotneedtochangetheentries.Tomakechanges,simplyovertypethefield.Anychangesyoumakemayberetainedanddisplayedthenexttimethesamepanelisdisplayed.

MVS-12-TSO


27/84

FundamentalsofTSO

5.2TerminalKeysA3270-typeterminalhasseveralprogrammablefunctionkeyscalledPFkeys.ToviewthevaluesofthePFkeysortochangetheirvalues,enterthecommandKEYSontheISPFcommandline.ThevaluesareusuallyshortISPForeditingcommands.Forexample,thePF3keyisusuallydefinedasEND;thePF4keyisusuallydefinedasRETURN.

Note:Programfunctionkeys(PF1,PF2,...,PF24),programattentionkeys(PA1,PA2),CLEARkey,INSERTkey,RESETkey,etc.,arenamesofkeysthatappearona3270typeterminal,whichyouareprobablynotusing.TheterminalemulatorsoftwarerunningonyourPCdeterminesthekeyboardmapping,i.e.,determineswhichkeyboardkeyscorrespondtothe3270-terminalkeys.Notallterminalemulatorsusethesamemapping.Ifyoudon'tknowthekeyboardmapping,checkthedocumentationwhichcamewithyourterminalemulatorsoftware.TheKEYScommanddoesnotaffect

thekeyboardmappingofyourterminalemulator,andthekeyboardmappingdoesnotaffectthevaluesassociatedwiththePFkeys.

On-linehelpisgenerallyavailablewithinISPF;presstheHELPkey(PF1)torequestHELPatanytime.Anon-linetutorialisavailablewhichexplainshowtouseISPFandwhatthevariousoptionsare;selectoptionTtobegintheISPFtutorial.

Panelsormenusareoftennested;thatis,onepanelmaycauseanotherpaneltoappear.ThePF3keyisusedtoexitapanelandreturntothepreviouspanel;usedrepea

tedly,itwilleventuallyreturntothemainmenu.IfthePF4keyisassignedthevalueRETURN,itcangenerallybeusedtoreturnimmediatelytothemainmenu.

ThePA1keymaybeusedtointerruptaprocess,suchasanexecutingprogram.ThePA2keyisusedtorefreshthescreenwithinISPF.TheCLEARkeyisusedtoclearthescreen;however,withinISPF,itisusuallynecessarytousethePA2keyimmediatelyafterusingtheCLEARkey.

5.3PFKeyListSomepanelsshowashortlistofavailablePFkeysatthebottomofthescreen;otherpanelsshownolistoronlyapartiallist.TocausethelistofavailablePFkeystoalwaysdisplayatthebottomofapanel,enterthefollowingcommandonanISPFcommandline:

PFSHOWON


28/84

Youcancontrolwhether12or24PFkeysareavailable.Ifyoudecidetohave24PFkeys,youcanalsocontrolwhethertohavethefirst12,thesecond12,orall24PFkeysappearinthemenuatthebottomofthescreen.UsethefollowingISPFcommandtocontrolthenumberandformatofPFkeysdisplayed:

MVS-13-TSO


29/84

FundamentalsofTSO

PFSHOWTAILOR

5.4PFKeyValuesThevalueofPFkeysmayvaryfromonepaneltothenext;i.e.,therearemultiplesetsofPFkeydefinitions,eachsethavingauniquename.OnegroupofpanelsmayuseaparticularsetofPKkeydefinitions,andanothergroupmayusethesameoradifferentsetofdefinitions.

YoucanchangethevalueofthePFkeys;however,itisrecommendedyoubecomefamiliarwiththeexistingvaluesandidentifywhichpanelsusethembeforemakinganychanges.

Severalmethodsexistformakingchanges.UseISPFoption0.3tochangethemainsetofPFkeydefinitions.UseISPFoption0.8tochangeothersetsofPFkeydefinitions,providedyouknowthenameofthesettobechanged.Ifyoudon'tknowthename,

gotothepanelforwhichthevaluesshouldbechangedandentertheISPFcommandshownbelow.

KEYS

5.5HelpKeyOnmostISPFpanels,thevalueofthePF1keyisHELP.YoucaneitherpressthePF1keyorenterthecommandHELPtogetcontextsensitivehelpinformation,whichisespeciallyusefulafterreceivinganerrormessage.

Ifyourequesthelp(bypressingPF1orenteringHELP)immediatelyafterreceivinganerrormessage,ISPFdisplaysadditionalinformationregardingtheerrorwhichhasjustoccurred.Requestinghelpagainmaydisplaymoreinformationonthesamesubjectoronabroaderscale.

5.6TechnicalNotesISPFrequiresapartitioneddatasetbeallocatedtotheddnameISPPROF;theallocationisdoneautomaticallyatlogontime.AtASU,thedatasetisnamed'userid.ISPFLIB',

where"userid"isreplacedwithyouruserid.Thisdataset(usuallytwotracks)shouldnotbedeleted;ISPFusesitforprocessingandtoretaincertainvaluesfromoneterminalsessiontothenext.ThedatasetiscreatedautomaticallywhenyoulogonTSOthefirsttime.Shouldyoueveraccidentallydeletethedataset,itwillbecreatedagainduringthenextlogon.


30/84

MVS-14-TSO


31/84

FundamentalsofTSO

ISPFrequiresaLOGfileandaLISTfile(bothareprintfiles)allocatedtotheddnamesISPLOGandISPLIST,respectively.Thisisdoneautomatically.YoucanuseISPFoption

0.2toexerciseadditionalcontrolofthesedatasets,suchassettingthedefaultProcessoptionfortheLOGfiletoD(delete)andfortheLISTfiletoPD(print,thendelete).YoucanalsousetheJCLtemplateatthebottomoftheLOG/LISTdispositionscreentoestablishafullyspecifiedJOBstatementanda/*ROUTEPRINTstatement.(DonotusethelinelabeledLocalprinterID.)TheJOBstatementandthe/*ROUTEPRINTstatementareusedtosubmitabatchjobwhichprintsthefileseachtimeyouexitISPF.(TheWYLBURformofaJOBstatementisnotvalidinTSO.)TheLOGfilecontainsalogofyourcurrentterminalsessions,andtheLISTfilecontainstheprintedresultsofcertainISPFcommands.(Printedoutputfrombatchjobsarenot

partofthesetwofiles.)Thesefilesusediskspacewhichcountstowardyourdiskquota.ISPFoption0.2includesfieldsfordeterminingthesizeofthesefiles

6.EDITORTheeditorprovidedwithISPF/PDFisISREDIT.Itiscommonlyreferredtobyavarietyofnames,includingSPF,PDF,SPF/PDF,ISPF/PDF,orISREDIT.Itisafull-screeneditorandmaybeusedtoeditamemberofapartitioneddataset(PDS)orasequentialdataset.("Library"isanothercommontermwhichreferstoaPDS.)Onlyabrief

descriptionoftheeditorisgiveninthisdocument.

Youcantypenewtextortypeoverexistingtextanywhereonthescreen.Certaineditingcommands,suchasI,C,MorD(Insert,Copy,MoveorDelete),canbeenteredinthelinenumberfields.Othereditingcommandsareenteredonthecommandline.UsethePF3keytoendeditingandautomaticallysavethechanges,oruseCANCELtoexitwithoutsavingthechanges.SAVEmayalsobeusedperiodicallytosavethechangeswithoutexitingtheeditor.

Ifthefilebeingeditedisintendedforbatchprocessing,theeditor'sSUBMITcommandmaybeusedtosubmitthedisplayedfiletothebatchqueue.IOFmaybeusedtomonitorthebatchjobortoretrieveitsoutput.

TheSPF/PDFeditorisinvokedfromtheISPFUtilities/Dslistmenu(option3.4)orfromtheprimaryISPFmenu(option2).

ISPFoption3.4istheeasiestmethodofinvokingtheeditor.Thisoptiondispla


32/84

ysalistofdatasetnames.Whenthelistisdisplayed,tabtolinecontainingthenameofthedatasettobeedited,typeanE,andpressenter.(Whenusingtheeditorviaoption3.4,anabbreviatedEditEntryPanelwillsometimesappear.Ifitdoes,justpressentertocontinue.)

ISPFoption2ismoreinvolvedandisdescribedinthefollowingparagraphs.(Whenusingtheeditorviaoption2,theentireEditEntryPanelwillalwaysappear.)

MVS-15-TSO


33/84

FundamentalsofTSO

Whenoption2isselected,theeditordisplaystheEditEntryPanelcontainingseveralinputfields,includingafieldforthenameofthedatasettobeedited.Afteryouhavetypedthedatasetnameandpressedenter,theeditorwilldisplaythefileifitcontainsdataorwilldisplayaninputscreenifthefileisempty.Asampleeditentrypanelisshownbelow:

EDITENTRYPANELCOMMAND===>

ISPFLIBRARY:

PROJECT===>

GROUP===>

TYPE===>

MEMBER===>(Blankorpatternformemberselectionlist)

OTHERPARTITIONEDORSEQUENTIALDATASET:

DATASETNAME===>

VOLUMESERIAL===>(Ifnotcataloged)

INITIALMACRO===>Enter"/"toselectoptionPROFILENAME===>/ConfirmCancel/Move/ReplaceFORMATNAME===>MixedMode

DATASETPASSWORD===>(Ifpasswordprotected)

Thedatasetnamemaybeenteredineitheroftwolocations:theDATASETNAMEfieldortheISPFLIBRARYfields(PROJECT,GROUP,andTYPE).IfboththeDATASETNAMEfieldandtheISPFLIBRARYfieldscontaindatasetnames,theDATASETNAMEfieldisused.OneusefulfeatureoftheISPFLIBRARYfieldsisthedatasetnameisretainedfromoneterminalsessiontothenext,butnotfortheDATASETNAMEfield.

TheDATASETNAMEfieldisbelow"OTHER...DATASET"inthemiddleofthescreen.Thisfieldmaybeusedforanysequentialorpartitioneddatasetname.Ifthe

datasetisaPDS,aparenthesizedmembernameshouldbeappendedtothedatasetname.Thedatasetnameandanymembernameshouldbeenclosedwithinsinglequotemarks.IfthefirstqualifierofthedatasetnamematchesyourPREFIX,thefirstqualifierandthequotemarksmaybeomitted.BydefaultyourPREFIXisequivalenttoyouruserid,unlessyouusetheTSOPROFILEcommandtochangethePREFIX.

Themembernameisrequiredforcreatinganewmemberandisoptionalforeditin


34/84

ganexistingmember.IfthemembernameisomittedforaPDS,amenuofexistingmembersisdisplayed;tabtothenameofthemembertobeedited,typeanSnexttothemembertobeeditedandpressenter.

EithertheISPFLIBRARYfieldsortheDATASETNAMEfieldmaybeusedifthefullyqualifieddatasetnamecontainsexactlythreequalifiers.RefertothepreviousparagraphforinstructionsonhowtousetheDATASETNAMEfield.FortheISPF

MVS-16-TSO


35/84

FundamentalsofTSO

LIBRARYfields,enterthefirstqualifierofthedatasetname(typicallyyouruserid)inthePROJECTfield;enterthesecondqualifierinthefirstGROUPfield;enterthelastqualifierontheTYPEfield.IfthedatasetisaPDS,enteramembernameintheMEMBERfield;themembernameisoptionalforeditinganexistingmember.IfthemembernameisomittedforaPDS,amenuofexistingmembersisdisplayed;tabtothenameofthemembertobeedited,typeanSnexttothemembertobeeditedandpressenter.

Thenextexampleillustratesselectingamemberfromamenuofexistingmembers:

EDIT---ABCDE.MOON.DATA7-----------------------ROW00001OF00004

COMMAND===>SCROLL===>PAGENAMEVV.MMCREATEDCHANGEDSIZEINITMODIDARMSTRON01.0091/08/0791/08/0717:43220ABCDE

CHEESE01.0091/08/0791/08/0717:26220ABCDE

sCRATER01.0091/08/0791/08/0717:13110ABCDEMOUNTAIN01.0091/08/0791/08/0717:14110ABCDE**END**

Beforetheeditorcanbeusedtoenterdataintoanewdataset,thedatasetmustexistasanemptyfile.ISPFoption3.2ortheTSOcommandALLOCATEmaybeusedtocreateanewemptydataset.

RegardlessofwhetheryouareusingISPFoption2or3.4,therearefivepossibleeditingsituations:

??Editanexistingsequentialdataset.

??Editanewsequentialdataset;anemptysequentialdatasetmustbecreated

priortoediting.

??

Editanexistingmemberinanexistingpartitioneddataset.

??Editanewmemberinanexistingpartitioneddataset.

??Editanewmemberinanewpartitioneddataset;anemptypartitioneddataset

mustbecreatedpriortoediting.


36/84

Inonlytwosituationsisitnecessarytocreateanew,emptydatasetpriortoinvokingtheeditor.Also,notethedifferencebetweeneditinganewmemberofanexistingdatasetandeditinganewmemberofanewdataset;onlythelatterrequiresanew,emptydatasettobecreated.(ISPFoption2isofteneasierthan3.4forcreatingamemberinanemptypartitioneddataset.)

Asageneralrule,itispreferabletocreateanewfileasamemberofapartitioneddatasetthantocreateitasasequentialdataset.Variouseditingtasksaresimplerwhenworkingwithpartitioneddatasets;andsomecommands,suchascopyingspecificlinesfromonefiletoanother,arenotpossiblewithsequentialdatasetsbutarewith

MVS-17-TSO


37/84

FundamentalsofTSO

partitioneddatasets.Sequentialdatasetsutilizediskspaceinefficientlyforsmallfilesandaremorecumbersometocreate.

7.BATCHJOBJCLFullyspecifiedJCL(JobControlLanguage)isrequiredforbatchjobssubmittedfromTSO.(FromWYLBUR,eitherfullyspecifiedJCLorpartialJCLisrequired.)Theterm"fullyspecifiedJCL"refersprimarilytothefollowingJCLstatements:

JCLStatementUsagenote

JOBrequiredROUTEoptionalJOBPARMoptionalTAPESoptionalOUTPUToptionalJCLLIBoptional

TheabovestatementsareinadditiontoanyotherJCLstatementsnormallyusedinabatchjob.Theotherstatements,primarilyEXECandDDstatements,arethoserequiredbythesoftware(SAS,FORTRAN,etc.)beingexecutedinthebatchjob.

TheSUBMITcommandisusedtosubmitthebatchjobforprocessing.Theoutputfromthebatchjobmaybeprinted,purged,orkeptinthequeuetobeviewedattheterminal.JCLstatementsdeterminewhethertheoutputisprintedorkeptinthequeueforviewing.TheIOFfacilityisusedtoviewtheoutput,changeprintdestinations,purge

output,etc.Theeditmacro%MAKEJOBmaybeusedtocreateafullyspecifiedJOBstatement.

ThefollowingillustratespropersyntaxoftheaforementionedJCLstatements:

//ABCDE###JOB(12345),NOTIFY=ABCDE,MSGCLASS=A,REGION=8M,TIME=(1,30)/*ROUTEPRINTKEEP


38/84

defaultprintdestinationisKEEP,thisstatementisusuallyomitted.??ReplaceLINESvalueontheJOBPARMstatementwithalargervalue,ifnecessary.Ifyourprintrequirementsarelessthen10thousandlines,thisstatementisusuallyomitted.

MVS-18-TSO


39/84

FundamentalsofTSO

??ReplacetheTAPESvaluewithnumberofneededconcurrenttapedrives(nottapevolumes).If

youarenotusingtapes,thisstatementisomitted.

??ReplacetheROOMvalueontheOUTPUTstatementifyouhaveanassignedsecuritybin.This

statementisusuallyomitted.

??ReplacetheprocedurelibrarynameSOME.PROC.LIBontheJCLLIBstatementwiththenameof

theprocedurelibrarytobeused.Thisstatementisusuallyomitted.

7.1JOBStatementTheJOBstatementisrequired;however,manyoftheparameters(positionalandkeyword)maybeomitted.Theonlyrequireditemsarethejobnameandtheaccountnumber.IntheexampleshownbelowABCDE###isthejobnameand12345istheaccountnumber.

//ABCDE###JOB(12345),NOTIFY=ABCDE,REGION=4M,TIME=(0,5)

AnalternativemethodforspecifyingaJOBstatementisavailable,thoughlimitedinfunctionality.ThismethodrequirestheJOBstatementtobereplacedinitsentiretybyaJCLcommentstatement.AJCLcommentstatementcontains//*incolumns1-3andablankincolumn4.Withthismethod,defaultvaluesarechosenforallparameters.Ajobnameisgeneratedconsistingofyouruseridanduptothreeadditionalcharacters;

thesystempromptsfortheadditionalcharacters.

Note:Theeditmacro%MAKEJOBisavailableinaneditingsession.Whenenteredontheeditorcommandline,%MAKEJOBinsertsafullyspecifiedJOBstatementintothefilebeingedited.AftertheJOBstatementisinserted,youcanadjusttheREGIONandTIMEvaluesifnecessary.

Thejobname(required)beginsincolumn3,is5to8charactersinlength,andisfollowedbyatleastoneblank.Thefirstpartofthejobnamemustbetheuserid

.Theremainingcharacters,ifany,maybealphanumeric(A..Z,0..9)ornational(@#$)characters.

Whenabatchjobissubmittedandthejobnameconsistsoftheuseridonly,thesystempromptsforadditionaljobnamecharacters.TheJOBstatementshouldhaveenoughspaceafterthejobname(orattheendofthefirstlineoftheJOBstatement)toallow


40/84

insertionofadditionaljobnamecharacters,elsetruncationofthejobnamewilloccur.)

7.1.1PositionalParametersPositionalparametersappearontheJOBstatementafterthewordJOB,beforeanykeywordparameters,andmustappearinaspecificsequence.

Theaccountingparameter(required)isthefirstpositionalparameterontheJOBstatement.Theaccountnumber(required)isthefirstvalueintheaccounting

MVS-19-TSO


41/84

FundamentalsofTSO

parameter.Theaccountnumbermustbevalidfortheuseridspecifiedinthejobname.Aroomcodemayappearaftertheaccountnumber.(Historically,theroomcodeintheJOBstatementwasusedasaplotdistributioncodeatASU.)Acommaisusedtoseparatetheaccountnumberfromtheroomcode.Parenthesesareusedtoenclosetheaccountingparameter.Ifonlytheaccountnumberispresent,theenclosingparenthesesareoptional.

Thenameparameter(optional,notshown)isthesecondpositionalparameter.Itisenclosedwithinsinglequotemarksandmaycontainupto20charactersofidentifyinginformation,suchastheprogrammer'sname.

7.1.2KeywordParametersAllkeywordparameters(identifiablebyanequalsign)maybespecifiedinanyorderontheJOBstatementandmustappearafterallpositionalparameters.Thereare

severalkeywordparameters,allofwhichareoptional.Onlythecommonlyusedparametersaredescribedinthisdocument.

TheNOTIFYkeywordparameter(optional)identifiesauseridtowhichajob-completionmessageshouldbesentoncethebatchjobcompletes.ItisnotnecessaryfortheNOTIFYuseridtomatchthejobnameuserid,thoughthisisusuallythecase.(TheWYLBURequivalent,//EXECWNOTIFY,shouldnotbeused.)

TheREGIONkeywordparameter(optional)declarestheamountofvirtualmemory

neededbythebatchjob.Ifthesystemdefaultissufficient,thisoperandmaybeomitted.

TheTIMEkeywordparameter(optional)declarestheamountofCPUtimeneededbythebatchjob.Ifthesystemdefaultissufficient,thisoperandmaybeomitted.

TheMSGCLASSkeywordparameter(optional)definestheprintclassfortheJCLlistingandmessages.MSGCLASS=ZmaybeusedtodiscardtheJCLlistingandmessages;however,thisisnotrecommendedsincemanyerrormessageswouldbediscarded,too.IfthedefaultMSGCLASSforyouruseridissufficient,thisoperandmay

beomitted.

YoumaydisplayorchangethedefaultMSGCLASS.ThefollowingLISTUSERcommanddisplaysthedefaultMSGCLASSforuseridABCDE.ThefollowingALTUSERcommandchangesthedefaultMSGCLASStoA.ThesecommandsareTSO/RACFcommands;theTSOcommandprefixisrequiredifthecommandsareenteredonanon-TSOcommandline.

COMMAND===>TSOLISTUSERABCDENORACFTSOCOMMAND===>TSOALTUSERABCDETSO(MSGCLASS(A))


42/84

MVS-20-TSO


43/84

FundamentalsofTSO

TheMSGLEVELkeywordparameter(optional,notshown)determinestheamountofjobcontrolinformation(JCL,messages)tobedisplayedinthejoblisting.Ifthesystemdefaultissufficient,thisoperandmaybeomitted.Theparametervaluecontains2numbersseparatedbyacommaandisenclosedinparentheses,forexample,MSGLEVEL=(2,1).Thefirstnumberappliestostatements,thesecondtomessages.

Statements:

0OnlyJOBstatements

1AllJCLandprocedurestatements

2OnlyJCLstatements

Messages:

0OnlyJCLmessages

1JCL,JES,andoperatormessages

RefertotheIBMJCLReferencemanualforinformationregardingotherkeywordparametersandforadditionalinformationonparameterspreviouslymentioned.

7.2ROUTEStatementTheROUTEstatementmaybeomittedifthedefaultprintjobdestinationforyouruseridissufficient.(UsetheLISTUSERcommandtodisplaythedefaultprintdestinationforyouruserid;usetheALTUSERcommandtoestablishadifferentdefaultprintdestination.)TheprintdestinationKEEPisrecommended.ItissimilartotheWYLBURFETCHqueue;i.e.,thebatchjoboutputiskeptintheprintqueuefor

viewing.(IOFmaybeusedtoviewthebatchjoboutputandtoprintorpurgeit.)

ThefollowingLISTUSERcommanddisplaysthedefaultprintdestination(andseveralotheritems)foruseridABCDE.ThefollowingALTUSERcommandchangesthedefaultprintdestinationtoKEEP(andmaybeusedtochangeotheritems,too).ThesecommandsareTSO/RACFcommands;theTSOcommandprefixisrequiredifthecommandsareenteredonanon-TSOcommandline.

COMMAND===>TSOLISTUSERABCDENORACFTSOCOMMAND===>TSOALTUSERABCDETSO(DEST(KEEP))

7.3JOBPARMStatementTheJOBPARMstatementsetsthemaximumnumberofprintlinesandmaybeomittedifthedefaultLINESvalueissufficient.LINES=10isthedefault,whichrepresents10thousandprintlines.

/*JOBPARMLINES=10


44/84

MVS-21-TSO


45/84

FundamentalsofTSO

7.4TAPESStatementTheTAPESstatementisusedtoidentifythenumberofconcurrenttapedrives(nottapevolumes)neededbyyourbatchjob.Themaximumis4.Ifyouarenotusingtapes,youshouldomitthisstatement.

/*TAPES1

7.5OUTPUTStatementPrintedoutputfrombatchjobsaresortedalphabeticallybythelastletteroftheuseridandplacedonshelvesinthecomputingsites,unlessasecuritybinnumberappearsonthebannerpage.Ifyouhaveanassignedsecuritybin,usetheOUTPUTstatementtoidentifythesecuritybinnumber.(TheOUTPUTstatementappearsaftertheJOBstatement.)Anyprintedoutputwithabinnumberwillbeshelvedinthecorrespondingsecuritybin.Inthefollowingexample,thesecuritybinisC2;replaceC2withyour

assignedsecuritybinnumber.

//BANNEROUTPUTDEFAULT=YES,JESDS=ALL,ROOM=#C2

7.6JCLLIBStatementTheJCLLIBstatementidentifiesoneormoreprocedurelibrariestobesearchedinadditiontothestandardsystemprocedurelibraries.Whenspecifyingmorethanoneprocedurelibrary,placeacommabetweeneachlibrarynameandenclosetheentirelistinparentheses.

ProcedurelibrarieslistedontheJCLLIBstatementaresearchedintheordertheyappearonthestatementandaresearchedbeforethestandardsystemlibraries.ThesearchorderforstandardsystemlibrariesisSYS1.ASU.PROCLIBandSYS1.PROCLIB.(SYS1.ASU.PROCLIBbecomespartofthestandardsystemsearchordereffectiveDec.21,1998.)

//JCLLIBORDER=SOME.PROCLIB//JCLLIBORDER=(MAIN.PROC.LIB,ANOTHER.LIB.NAME)

8.BATCHJOBSUBMITTALTheSUBMITcommandisusedtosubmitbatchjobsfromTSOtotheMVSbatchsystemforprocessing.TheprocedureisnearlyidenticaltothatusedbyWYLBUR;theprimarydifferencebeingTSOrequiresfullyspecifiedJCL.

Theoutputfromthebatchjobmaybeprinted,purged,orkeptinthequeuetobe


46/84

viewedattheterminal.JCLstatementsdeterminewhetherthebatchjoboutputis

MVS-22-TSO


47/84

FundamentalsofTSO

printedorkeptinthequeueforviewing.TheIOFfacilityisusedtomonitorbatchjobs,viewtheoutput,changeprintdestinations,purgeoutput,etc.

ThereareactuallytwoformsoftheSUBMITcommand:thenativeTSOcommandand

theSPF/PDFeditorsub-command.CommandtypeSyntaxSPF/PDFeditorsub-commandSUBMITnativeTSOcommandSUBMITdsnameSUBMIT(dsnamedsname...)

8.1SPF/PDFSUBMITCommandTheSPF/PDFSUBMITcommandisusedonlywhentheeditorisdisplayingafilewhosecontentsisthebatchjobtobesubmitted.Inotherwords,usetheeditortodisplaythefileyouwanttosubmitforbatchprocessing.

Oncethefiletobesubmittedisdisplayedonthescreen(andafteryouhavemadeanydesiredchanges),entertheSUBMITcommandontheeditorcommandline:

COMMAND===>SUBMIT

Theentirefileissubmittedforprocessing,unlessalinerangeoptionisspecifiedtocauseonlyaportionofthefiletobesubmitted.

8.2TSOSUBMITCommandTheTSOSUBMITcommandmaybeusedatanytime,evenwhentheeditorisbeingused.TheoperandforthisSUBMITcommandisaparenthesizedlistcontainingthenamesofthedatasetstobesubmittedforbatchprocessing.Ifonlyonedatasetnameis

present,theenclosingparenthesesmaybeomitted.Anynon-quoteddatasetnameisassumedtohave"CNTL"asthelastqualifier;however,ifnosuchdatasetexiststhenthedatasetnamewithout"CNTL"isused.

Forexample,assumingtheuseridisABCDEandthejobtobesubmittedisthememberMYJOBindatasetABCDE.TSOLIB.CNTL,thecommandtosubmitthejobis:

COMMAND===>TSOSUBMITTSOLIB(MYJOB)

Note:TSOfirstsearchesforTSOLIB.CNTL(MYJOB)andthenforTSOLIB(MYJOB).TSO

submitsthefirstonefound.

NotethewordTSOintheabovecommand.ThiswordisrequiredasacommandprefixforanyTSOcommandenteredonanISPFcommandlineoranSPF/PDFeditor

MVS-23-TSO


48/84

FundamentalsofTSO

commandline.IfaTSOcommandisenteredonaTSOcommandlineorontheCOMMANDscreenofISPF(option6ontheprimarymenu),thecommandprefixisnotrequired.

AcommoninstanceofwhentousethenativeTSOcommandwithmultipledatasetnamesiswhenthebodyofthebatchjobiscontainedinonefilebuttheJCLJOBstatement(andperhapsotherJCLstatements)areinaseparatefile.

COMMAND===>TSOSUBMIT(TSOLIB(JCL)TSOLIB(PROG1))

NotetheuseofparenthesesenclosingthedatasetnamesandtheuseoftheTSOcommandprefix.

AcommonmistakemadewiththeTSOSUBMITcommandoccurswhenoneofthefilesbeingsubmittedisalsobeingedited.Unlike,theSPF/PDFSUBMITcommand,theTSOSUBMITcommandusesthecontentsofthefileasitcurrentlyexistsondisk.AnyeditingchangesmadetothefiledonotparticipateintheTSOSUBMITunlessthe

updatedfileissavedpriortosubmission.

Besidessyntax,thereisanotherdifferencebetweentheeditorSUBMITcommandandtheTSOSUBMITcommand.TheTSOSUBMITrequiresthedataset(s)tohavecard-imageformat(i.e.,RECFMFBandLRECL80);theeditorSUBMITallowsfixedorvariableformat(RECFMFBorVB)andanylogicalrecordlength.(Actually,theeditorcommandcopiesthedisplayeddatasetintoatemporarydatasethavingcard-imageformatandthenusestheTSOcommandtosubmitthetemporarydatasetforprocessing.)

ForeitherSUBMITcommand,ifthejobnameofabatchjobconsistsoftheuseridonly,thesystempromptsforadditionaljobnamecharacters.Oneormorenumbersarerecommendedastheadditionalcharacters.(Themaximumsizejobnameiseightcharacters.Iftheuseridisfivecharactersthenonetothreeadditionalcharactersshouldbetypedattheprompt.)

9.IOF(FetchingBatchJobOutput)ThefacilitywhichprovidesmonitoringandcontrolofMVSbatchjobsiscalledIOF(InteractiveOutputFacility).IOFprovidesfacilitiesformonitoringtheprogre

ssofbatchjobsqueuedforexecution,executing,andcompleted.IOFcanalsobeusedtocancelactivejobsandtoreview,print,purge,orredirectoutputfromjobsthathavecompleted.IOFperformsthesamefunctionsastheWYLBURcommandsCANCEL,FETCH,LOCATE,PRINT,ROUTE,andPURGE.

MVS-24-TSO


49/84


50/84

FundamentalsofTSO

9.1InvokingIOFIOFisinvokedbychoosingoptionIfromtheISPFmainmenu.Onceselected,ascreensimilartothefollowingappears.(ThefirsttimeyouuseIOFaone-timescreenwillappearwhichtellsyouhowtocustomizeIOF.PressEntertocontinue.)

IOFJOBLISTMENUCOMMAND===>SCROLL===>PAGE------------------------RUNNINGJOBS---------------------------------JOBNAME---JOBID--ACT-STA-SYID----CPU---I/O---STEP-----PROCSTEP-SWP_1ABCDET04982MVS2:028.79ISPFPDFSIN-------------------------OUTPUTJOBS---------------------------------JOBNAME---JOBID--ACT-STA-OWNDER---DEST/DEVICE---RECS-------------_2ABCDE36J05240ABCDEUCC1937_3ABCDE41J05311ABCDEKEEP2307

F1=HELPF2=SPLITF3=ENDF4=RETURNF5=IFINDF6=FIND'F7=UPF8=DOWNF9=SWAPF10=LEFTF11=RIGHTF12=RETRIEVE

Tolookatthebatchjoboutput,tabtothejobofinterestandtypeBtothele

ftofthejobnameandpressenter.

Toprintthebatchjob,tabtothejobofinterestandthencetothedestinationfield;typeaprinternameovertheexistingdestinationandpressenter.

ToexitIOF,presstheENDkey(PF3)oneormoretimes.

TogettheIOFmainmenu,type/onthecommandlineandpressENTER.Aportionofthemainmenuisshownbelow.

IOFUSEROPTIONMENUCOMMAND===>Selectanoption.blank=YourjobsG=OutputgroupsQT=QuicktutorialI=InputjobsJ=AlljobsmenuHELP=HelpR=RunningjobsH=JobswithheldoutputO=OutputjobsP=ProfileJOBNAMES===>

9.2On-lineHelpandTutorialOn-lineHelpisavailablewithinIOF.TypeHELPonanycommandlinewithinIOForpresstheHELPkey(PF1),andahelpscreenwillappear.InvokingHelpfromthe

IOF

MVS-25-TSO


51/84


52/84

printfileswithinthebatchjob(recommended),usetheP?prefixcommandontheIOFJobSummarypanelforthedesiredprintfiles.P?displaysanotherpanelcontainingaprintdestinationfield;typeavaliddestinationonthislatterpaneltoprinttheselected

MVS-26-TSO


53/84

FundamentalsofTSO

file.(Bydefault,printingtheentirejobresultsintheoutputjobbeingremovedfromthemainframeprintqueue.PrintingselectedportionswithP?doesnotremovetheoutputjobfromthemainframeprintqueue.)

Note:IftheprintdestinationisanASUIT-providedprinterinapublicsite,theprintjobisnotphysicallyprinteduntilafterpaymentismadefortheprintedoutput.Paymentmustbemadewithintwohoursofinitiatingtheprintrequestelsetheprintrequestispurgedfromtheprintersqueue.Iftheprintrequestispurged,anotherprintrequestcanbeinitiatedprovidedtheoutputjobstillexistsinthemainframeprintqueue.(TheP?methodisrecommendedforprintingfilesbecauseP?doesnotremoveoutputjobsfromthemainframeprintqueue.)

RefertotheIOFon-lineHelpandtutorialforinformationonothercommands.

9.6HeldOutputAnyprintfilesusingSYSOUTclassWareconsideredHeldOutput.(SYSOUTclassWisthestandardTSOHoldOutputprintclassatASU.)PrintfilesusingprintclassesotherthanWappearinOutputJobs.UseofSYSOUTclassWisanalternativemethodofkeepingoutputintheprintqueueforsubsequentbrowsing.UseofprintdestinationKEEP,whichaccomplishesthesamething,isrecommendedsinceitallowsallprintfilestoappearonthesamedisplayscreen.

Toprintaheldoutputfile,typeavalidclassletter(typicallyA)overtheexistingclassletterandfollowtheprocedurelistedintheprevioussectionforOutputJobs.RefertotheIOFon-lineHelpandtutorialforinformationonothercommands.

9.7SaveBatchOutputtoDiskSomeportionorallofacompletedbatchjobmaybesavedtodisk.OntheIOFJobListMenu,entertheprefixcommandSintheleftmostpositionoftheIOFlinecorrespondingtothejobtobeactedupon.ThiscausestheIOFJobSummaryscreento

bedisplayed.

Tosavetheentirejobtodisk,enterthefollowingthreeprimarycommandsonthecommandline.(ReadthisentiresectionbeforeusingSD.)

SD/*Displaymenuwhereontheoutputdiskfileischosen*/SNAP/*Savetheentirebatchjobtodisk*/SNAPCLOS/*Closethediskfile*/


54/84

Theprocesstosaveoneormoreprintfilestodiskissimilartosavingtheentirejobtodisk,excepttheSNAPprimarycommandisreplacedbyoneormoreNprefixcommands.TheNprefixcommandistypedintheleftmostpositionoftheIOFline

MVS-27-TSO


55/84

FundamentalsofTSO

correspondingtotheprintfiletobeactedupon.Thefollowingsamplesavesthreeprintfilestodisk.(ReadthisentiresectionbeforeusingSD.)

SD/*Displaymenuwhereontheoutputdiskfileischosen*/N/*Prefixcommandtosaveprintfiletodisk*/N/*Prefixcommandtosaveprintfiletodisk*/N/*Prefixcommandtosaveprintfiletodisk*/SNAPCLOS/*Closethediskfile*/

TheSDcommandwithnooperandscausestheIOFSnapDataSetOptionsscreentobedisplayedwhereonyouchoosethediskfileintowhichtheoutputistobesaved.Thedefaultdatasetnameisjobname.IOFLIST.Youcanchooseanothernameorchangeothersettingsassociatedwiththedataset.Thedatasetwillbeautomaticallycreatedifitdoesnotalreadyexist.

TheSDcommandwiththeDATAoperand,whichidentifiesanexistingdatasetfor

savingtheoutput,bypassesdisplayoftheIOFSnapDataSetOptionsscreen.Thepreviouscontentsofthedatasetareoverwritten.Thesyntaxisasfollows:

SDDATA(datasetname)/*Identifyoutputdiskfile*/

10.RACF(DiskandTapeSecurity)RACF(ResourceAccessControlFacility)isusedtodefineaccountattributes,providedatasetsecurity,andcontrolaccesstovarioussystemcomponents.Securityisbasedonuserids.

RACFcanbeaccessedviaISPFoption9(IBMSOFTWARE)orascommandsontheTSOorISPFcommandline.IfaccessedviaISPF,aRACFtutorialisavailable;selectoptionTontheRACFmainmenu.(RACFcommandsenteredonanISPFcommandlineshouldbeginwiththewordTSO.)

FromtheRACFmenuinISPF,option1isusedtochangediskfilesecurity,option2isusedfortapevolumesecurity,andoption4isusedtodisplayorchangevariousattributesforyouraccount.Refertotheon-linehelpandtutorialforinformationonhowtousetheRACFpanels.

10.1ProfileNamesInformationcontainedintheRACFdatabasedefinesthesecurityforeverythingwithinthesystem.Eachentryinthedatabaseiscalledaprofile,andeachentryhasaname.Typically,adatasetname(orapatternwhichmatchesadatasetname)oratapevolumeserialnumberisusedasthenameforaRACFprofile.


56/84

MVS-28-TSO


57/84

FundamentalsofTSO

TheRACFcommandsandmenusassumethatdatasetnamesconformtotheTSOnamingconvention.AnydatasetnameswhichdonotconformtotheTSOnamingconventionorforwhichthefirstqualifierdoesnotmatchyourPREFIX(typicallyyouruserid)shouldbeenclosedinquotes.

Initsstandardconfiguration,RACFdoesnotworkwithnon-TSOnamingconventions.AtASU,RACFinternallygivesTSO-typenamestoRACFprofilesassociatedwithWYLBUR-typenames.Forexample,ifaRACFprofilewerecreatedforthedataset'WYL.AB.CDE.DATA',RACFwouldcreateaprofilenamed'ABCDE.WYL.DATA.Generally,youneednotbeawareofthedifference;however,whendisplayingalistofexistingprofiles,theRACFgeneratednamesarebedisplayedinsteadoftheWYLBUR-typenames.

10.2DiskFileSecurityYoucangiveoneormoreuseridsaccesstooneormorediskdatasets.Thedataset(s)maybeidentifiedbyaspecificname(onedataset)orbyapatterncontaininga

sterisks(manydatasets).ThedatasetnameorpatternisalsotheRACFprofileentryname.Forpatternmatching,asingleasterisk(*)matchesonequalifier;doubleasterisks(**)matchmultiplequalifiers.

'ABCDE.PROJECT.DATA'/*matchesonedataset*/'ABCDE.*.SAS'/*manydatasetswiththreequalifiers*/'ABCDE.PROJECT.*'/*manydatasetswiththreequalifiers*/'WYL.AB.CDE.**'/*alldatasetswithWYLBUR-typenames*/'ABCDE.**'/*alldatasets*/

Note:BecauseRACFinternallygivesTSO-typenamestoRACFprofilesassociatedwithWYLBUR-typenames,thelastexamplegivenabove('ABCDE.**')wouldmatchalldatasetnames,bothTSO-andWYLBUR-typenames.

10.3TapeVolumeSecurityTapesecurityisappliedtotheentiretaperatherthantoindividualfiles.ThenameofatapeRACFprofileisthetape'svolumeserialnumber.(Note:Tapeprofilesareknownas"generalresources"andbelongtothe"tapevol"class.Thisinformationisne

ededwhenusingtheISPFmenusforchangingsecurityassociatedwithtapevolumes.)

10.4LISTUSERTheLISTUSERcommanddisplaystwoseparatecomponents,oneforRACFandtheotherforTSO.Thecommandcandisplayeitherorbothcomponents.

MVS-29-TSO


58/84


59/84

FundamentalsofTSO

LISTUSERuserid/*listRACFinformationonly*/LISTUSERuseridNORACFTSO/*listTSOinformationonly*/LISTUSERuseridTSO/*listRACFandTSOinformation*/

10.4.1DisplayDiskQuotaAsamplelistingofthefirstfewlinesoftheRACFinformationisshownbelow.DiskquotainformationisshownontheINSTALLATION-DATAline.ThenumberassociatedwithMAXistheuserid'smaximumdiskspacequotaintracks;thenumberassociatedwithUSEDisthenumberoftrackscurrentlyusedbytheuserid.USER=?????NAME=?????????OWNER=?????CREATED=89.140DEFAULT-GROUP=USERSGRP0PASSDATE=91.190PASS-INTERVAL=90ATTRIBUTES=NONEREVOKEDATE=NONERESUMEDATE=NONELAST-ACCESS=91.247/18:55:48CLASSAUTHORIZATIONS=NONEINSTALLATION-DATA=MAX(00100)USED(00000025)NO-MODEL-NAMELOGONALLOWED(DAYS)(TIME)

ANYDAYANYTIME

Note:AsofApril2002,diskquotasarenotenforced.Theinformationhasbeenleftinthisdocumentforhistoricalpurposes.

10.4.2DisplayAccountNumberAsamplelistingoftheTSOinformationisshownbelow.TheitemsofnotearethedefaultMSGCLASSforbatchjobs(MSGCLASS),thedefaultSYSOUTclassforprintedoutput(SYSOUTCLASS),thedefaultbatchjobprintdestination(DEST),theaccount

number(ACCTNUM),thedefaultdiskunitforcreatingnewdiskdatasets(UNIT),theamountofvirtualmemorybeingused(SIZE),andthemaximumamountofvirtualmemoryavailablefortheterminalsession.TSOINFORMATIONACCTNUM=12345DEST=UCC1HOLDCLASS=WMSGCLASS=APROC=ISPFPDFSSIZE=0004096MAXSIZE=0008192SYSOUTCLASS=A

UNIT=RESRCH

10.5ALTUSERTheALTUSERcommandmaybeusedtochangecertainitems(butnotall)intheRACFandTSOcomponentsdisplayedbytheLISTUSERcommand.Severalofthemoreusefulcommandsareshownbelow:


60/84

MVS-30-TSO


61/84

FundamentalsofTSO

ALTUSERuseridTSO(DEST(KEEP))/*Setprintdestto"fetch"queue*/ALTUSERuseridTSO(MSGCLASS(A))/*SetMSGCLASSforbatch*/

ThereisnoneedtochangePROCorSIZEsincethesetwowillnottakeeffectuntilthenextlogon,atwhichpointyoucanalterthemonthelogonscreen.

11.TSOCOMMANDSTSO"commands"maybebuilt-incommands,programs,orexecs.Regardlessofthetype,thecommandshavethesamegeneralformatandareenteredontheTSOcommandline.ThecommandsmayalsobetypedontheISPFcommandlinebutmusthavethewordTSOappendedtothefrontofthecommand;thiswordinformsISPFthatthecommandshouldbesubmittedtoTSOforprocessing.

(ISPFalsohasasetofcommands.ThesecommandscanonlybeenteredonanISPFcommandline,notonaTSOcommandline.)

11.1ALLOCATETheALLOCATE(orALLOC)commandisusedtoallocatefiles.ItperformsthesamefunctionasaJCLDDstatement.Itassociatesaddname(DD)withadatasetname

(DSN).WithsomesoftwaretheALLOCcommandisoptional.Forexample,SASandFORTRANareabletoreadorwritefileswithorwithoutusingtheALLOCcommand;othersoftwareneedtheALLOCcommand.

DatasetnamesintheALLOCstatementmaybefullyqualified,and,ifthedatasetispartitioned,aparenthesizedmembernamemaybeappendedtothedatasetname.Singlequotemarksshouldenclosefullyqualifieddatasetnames.Withouttheenclosingquotemarks,thesystemwillassumethatthecurrentPREFIX(typicallyyouruserid)shouldbeaffixedtothedatanametoformafullyqualifieddatasetna

me.Forinputfiles,alistofdatasetnamesmaybeusedtologicallyconcatenatethefilesintoonelargerfile.

Writetoanexistingdataset:ALLOCDD(ddname)DSN(datasetname)OLD

Readfromanexistingdataset:ALLOCDD(ddname)DSN(datasetname)SHRREUSE

Readfromanexistingdataset(usedbyFORTRANprograms):ALLOCDD(ddname)DSN(datasetname)SHRREUSEINPUT

Writetoanewsequentialdataset:

ALLOCDD(ddname)DSN(datasetname)NEWCATALOGREUSE

SPACE(primarysecondary)TRACKSUNIT(RESRCH)RELEASE


62/84

RECFM(FB)LRECL(80)BLKSIZE(7440)

MVS-31-TSO


63/84

FundamentalsofTSO

Writetoanewpartitioneddataset:

ALLOCDD(ddname)DSN(datasetname(member))NEWCATALOGREUSESPACE(primarysecondary)TRACKSDIR(blocks)UNIT(RESRCH)RECFM(VB)LRECL(259)BLKSIZE(7476)

Writetotheprinter:ALLOCDD(ddname)SYSOUT(A)DEST(destination)

Readfromorwritetotheterminal:ALLOCDD(ddname)DSN(*)

Readfromorwritetoa"dummy"file:ALLOCDD(ddname)DUMMY

??ALLOCisthecommand.??DD(...)identifiestheddname.??DSN(...)identifiesthedatasetname(s)and/ormember(s).DSN(*)represents

the

terminal.??OLDindicatesthedatasetexistsandwillbereadand/orwritten.??SHRindicatesthedatasetexistsandwillberead.??INPUTisusedalongwithSHRbutisonlyneededbyFORTRANprograms.??NEWindicatesthedatasetdoesnotyetexistbutisbeingcreated.??CATALOGisusedalongwithNEWtocataloganewdataset.??REUSEindicatesthatiftheddnameisalreadyinuse,theexistingallocation

shouldbefreedandtheddnamereused.

??SPACEindicatesthesizeofanewdataset;"primary"istheinitialsizeand"secondary"istheincrementneedediftheprimarysizeistoosmall.??TRACKSindicatesthatSPACEisallocatedintracks.CYLisusedtoallocatespaceincylinders.??DIRindicatesthatapartitioneddatasetisbeingcreatedand"blocks"indicates

thenumberofdirectoryblocksneeded.??RELEASEreturnsunusedtracksorcylinderstothesystem.??UNITindicatesthediskvolumestocontainnewdatasets.??RECFMistherecordformat.??LRECListhelogicalrecordlength.

??BLKSIZEistheblocksizeofthedataset.??SYSOUTindicatesaprinterfile.??DESTindicatestheprintdestination.??DUMMYindicatesthefileisadummyfile.

11.2CALLCALLisusedtoexecutealoadmodule,thebinaryexecutableformofaprogramwhichhaspreviouslybeenlink-edited.Ifthefirstqualifierofthedatasetnamecon


64/84

tainingtheloadmoduledoesnotmatchyourPREFIX(typicallyyouruserid)orifthelastqualifierisnotLOAD,thedatasetnamemustbefullyqualifiedandenclosedwithinsingle

MVS-32-TSO


65/84

FundamentalsofTSO

quotesonthecommandline;otherwise,boththefirstandlastqualifiershouldbeomittedonthecommandline.

Executealoadmoduleandpassruntimeparameters:CALL'fulldatasetname(member)''parameters'

Executealoadmodulewithashortenedname:CALLshortname(member)

11.3DELETEDELETEisusedtodeleteadataset.ISPFalsohasseveralmethodstodeleteadataset.

Deleteamember:DELETEdatasetname(member)

Deleteadataset:

DELETEdatasetname

11.4EXEC11.4.1ExplicitExecsEXECisusedtoexplicitlyexecuteaCLISTorREXXexec.(CLISTsandREXXexecsmayalsobeexecutedimplicitlyifthelibrariescontainingtheCLISTsandREXXexecsareassignedtotheddnamesSYSPROCorSYSEXEC.)

YoumaycreateyourownexecsusingeitherREXXorCLIST,butREXXisrecommended.ItishighlyrecommendedthatthefirstlineofanyREXXexecbegin

withthecomment/*REXX*/.Dependingonthemethodusedtoinvoketheexec,thecommentissometimesrequired.

TheEXECcommandrequiresadatasetname(includingamembernameifnecessary).IfthedatasetnameisfullyqualifiedorifthefirstqualifierofthedatasetnamedoesnotmatchyourPREFIX(typicallyyouruserid)orifthelastqualifierofthedatasetnameisnotCLISTorEXEC,thedatasetnamemustbeenclosedinparenthesis.

IfthefirstdatasetnamequalifierisyourPREFIXandthelastqualifierisCL

ISTorEXEC,thefirstandlastqualifiersareomitted.Theremainingportionofthedatasetname,ifany,andthemembernameisspecified.

ExecuteaCLIST;for"shortnames",thelastqualifiermustbeCLISTand

mustbeomitted:

EXEC'fullname(member)''parameters'


66/84

EXEC'fullname(member)''parameters'CLIST

EXECshortname(member)'parameters'

EXECshortname(member)'parameters'CLIST

MVS-33-TSO


67/84

FundamentalsofTSO

ExecuteaREXXexec;for"shortnames",thelastqualifiermustbeEXECandmustbeomitted;forthetwoexampleswithoutthe"EXEC"keywordattheend,thefirstlineoftheexecmustcontainacommentcontainingthewordREXX(/*REXX*/):EXEC'fullname(member)''parameters'EXEC'fullname(member)''parameters'EXECEXECshortname(member)'parameters'EXECshortname(member)'parameters'EXEC

??The'parameters'maybeomittedfromthecommandlineifnoparametersaretobepassedtotheCLISTorREXXexec.??TheCLISTkeywordattheendofthecommandlineshouldonlybespecifiedforCLISTs.??TheEXECkeywordattheendofthecommandlineshouldonlybespecifiedforREXXexecs.

??IfneitherCLISTnorEXECisusedattheendoftheline,CLISTisassumedasthelastqualifierfora"shortname";however,theprocessorexaminesthefirstline

ofthefiletodeterminewhetheraCLISTorREXXexecisbeinginvoked.Ifthefirstlinecontains/*REXX*/,aREXXexecisassumed;otherwiseaCLISTisassumed.

11.4.2ImplicitExecsCLISTsandREXXexecsmaybeexecutedimplicitly.Inthisinstance,theEXECcommandisnotused;themembernameoftheexecisusedasifitwereacommand.ThisrequiresthattheCLISTorREXXexecsresideinlibrarieswhichareassignedtotheddnamesSYSPROCorSYSEXEC.

ThelibrariesassignedtoSYSPROCmaycontainCLISTSand/orREXXexecs.ThelibrariesassignedtoSYSEXECmaycontainonlyREXXexecs.Therecordformatofthelibrariesmaybefixed(FB)orvariable(VB),butmustmatchtherecordformatofanyexistinglibrariesalreadyassignedtotheddname.Therecordlengthmaybeupto255forfixedformator259forvariableformat,butforfixedformattherecordlengthmustmatchanyexistinglibrariesalreadyassignedtotheddname.

CAUTION:SYSPROCispre-allocatedtonumeroussystemlibraries.IfyouaddanylibrariestoSYSPROC,besuretoincludetheexistingsystemlibrarieswhenreal

locatingSYSPROC.Thesystemlibrariesareincard-image(fixedformatwithrecordlengthof80);anyadditionallibrariesshouldalsobecard-image.

CAUTION:SYSEXECmaybepre-allocatedtovarioussystemlibraries.IfyouaddanylibrariestoSYSEXEC,besuretoincludetheexistingsystemlibrarieswhenreallocatingSYSEXEC.AlllibrariesallocatedtoSYSEXECshouldmatchinrecordformat(and


68/84

recordlengthforfixedformat).Also,SYSEXECwillnotbesearchedforanyREXXexecsunlessSYSEXECsearchingisactivated.TheEXECUTILcommand,describedbelow,isusedtoturnSYSEXECsearchingonoroff.(AtASU,theSYSEXECsearchingisonbydefault.)

MVS-34-TSO


69/84

FundamentalsofTSO

ExecuteaCLISTorREXXexecimplicitly:membernameparameters%membernameparameters

??Theparametersareoptionalandmaybeomitted.

??The%isoptionalandmaybeomitted;however,useof%resultsinslightlyimprovedperformance.Thesystemnormallychecksseverallibrariesbeforetheexeclibraries;the%informsthesystemtocheckonlytheexeclibraries.

11.5EXECUTILEXECUTILdetermineswhetherornottheddnameSYSEXECissearchedforimplicitexecs.Bydefault,onlytheddnameSYSPROCissearchedforimplicitexecs.(SYSEXECmaycontainonlyREXXexecs;SYSPROCmaycontainCLISTSandREXXexecs.)EXECUTILmaybeexecutedatanytimetoactivateordeactivatesearchingofSYSEXEC.

Turnsearchingon:EXECUTILSEARCHDD(YES)

Turnsearchingoff:EXECUTILSEARCHDD(NO)

11.6FREEFREEisusedtodeallocateddnamesordatasets.Whenattemptingtoreallocateaddname,theddnamemustfirstbefreed,elsetheREUSEparameterisneededontheALLOCstatement.Ifthedatasetbeingfreedispartofaconcatenationlist,youshould

freetheddnameinstead.

Freeoneormoreddnames:FREEDD(ddname)FREEDD(ddname1ddname2etc.)

Freeoneormoredatasets:FREEDSN(datasetname)FREEDSN(datasetname1datasetname2etc.)

Freeaprintfileddnameandchangethedestination:

FREEDD(ddname)DEST(newdest)

11.7FTPFTPisusedtotransferfilesfromoneusertoanother,usuallybetweendifferentcomputingsystems.

EstablishanFTPconnectionwithanothersystem:FTPip-address


70/84

MVS-35-TSO


71/84

FundamentalsofTSO

11.8HELPHELPisusedtodisplayvariousTSOhelptopics.ThisformofHELPdoesnotuseISPF.

Displaylistofavailablehelptopics:HELP

Displayaspecifichelptopic:HELPtopic

11.9IOFIOFisusedtomonitortheprogressofbatchjobsqueuedforexecution,executing,andcompleted.IOFcanalsobeusedtocancelactivejobsandtoreview,print,purge,orredirectoutputfromjobsthathavecompleted.IOFperformsthesamefunctionsastheWYLBURcommandsCANCEL,FETCH,LOCATE,PRINT,ROUTE,andPURGE.

Displaybatchjobandprintqueues:IOF

(IOFcanalsobeinvokedbychoosingoptionIfromtheISPFmainmenu.)

11.10ISPFISPFisusedtostarttheISPFshell,whichprovidesaseriesofmenustosimplifyusageofTSOandprovidesadditionalfunctionality,includingafull-screeneditor.WhenISPFstarts,itautomaticallydisplaystheprimarymenu;however,youcanincludeanoption

tocauseittostartwithadifferentmenu.Validoptionsarethosethatwouldbevalidontheprimarymenu.

StarttheISPFshell:ISPF[option]

11.11ISRDDNISRDDNisaTSOprocedurethatcanonlybeinvokedfromanISPFcommandline.ItprovidesanISPFscreenwhichdisplaysthecurrentlyallocatedddnamesanddatasets.

Otherfunctions(e.g.,editorbrowse)canbeinvokedfromthescreen.

Displayallocatedddnamesanddatasetnames:ISRDDN

(SeealsoLISTALC.)

MVS-36-TSO


72/84


73/84

FundamentalsofTSO

11.12LINKLINKinvokesthelinkageeditortocreateabinaryexecutableprogramfromtheobjectcodedatasets.

Linkseveralobjectcodefiles:LINK(objectcode1objectcode2etc.)

Linkanobjectcodefilealongwithanysubroutinelibraries:LINK(objectcode)LIB(maybe-imsl-library)

Linkanobjectcodefile,asubroutinelibrary,andputtheloadmoduleinaspecificloadmodulelibrary:

LINK(objectcode)LOAD(load-library-name)LIB(some-library)

??Oneormorenamesofobjectcodedatasetsformthefirstpositionalparameter.IfthefirstqualifierofanobjectcodedatasetisyourPREFIX(typicallyyouruserid)andthelastqualifierisOBJ,thefirstandlastqualifiersmaybeomit

ted.

??UseofIMSLorothersystemprovidedlibrariesrequirethefullyqualifieddatasetnamesofthelibrariesbeincludedintheLIBparameter.

??WithouttheLOADparameter,LINKgeneratesaloadmodulenamesimilartotheobjectcodedatasetname.It'srecommendedthatyouprovidealoadmodulename,preferablyonethatalreadyexists.

11.13LISTALCLISTALCdisplaysthecurrentlyallocatedddnamesanddatasets.

Displayallocatedddnamesanddatasetnames,exceptsystem-generateddatasetnames:LISTALC

Displayallallocatedddnamesanddatasetnames,includingsystemgenerateddatasetnames:LISTALCSYSNAMES

(SeealsoISRDDN.)

11.14LISTCATLISTCATdisplaysalistofcatalogedfilesforwhichthefirstqualifiermatchesyour

PREFIX(typicallyyouruserid).TheLEVELoperandisneededtodisplayadifferentlist.ISPFalsohasanoptiontodisplaythesimilarinformationinafull-screenformat.

Displaycatalogentriesbeginningwithyouruserid:LISTCAT

MVS-37-TSO


74/84


75/84

FundamentalsofTSO

DisplaycatalogentriesbeginningwithWYL.AB.CDE:LISTCATLEVEL(WYL.AB.CDE)

11.15LISTDSLISTDSdisplaysdatasetattributeinformation,suchasrecordformat,blocksize,ormembernames.ISPFhasseveralmoreconvenientmethodsforobtainingthesameinformation.

Displaydatasetattributes:LISTDSdatasetname

Displaymembernamesinapartitioneddataset:LISTDSdatasetnameMEMBERS

11.16LOADGOLOADGOisusedtoloadobjectcodeintomemory,link-editingitasit'sloaded,and

thenexecutingitwithoutcreatingabinaryexecutablefile(loadmodule).Alternately,oneoftheISPFpanelsprovidesamethodfordoingasimilarprocess.

Loadandexecuteseveralobjectcodefileswithruntimeparameters:LOADGO(objectcode1objectcode2etc.)'parameters'

Loadandexecuteobjectcodealongwithanysubroutinelibraries:LOADGO(objectcode)LIB(maybe-imsl-librarymaybe-calcomp)

??UseofIMSLandothersystemprovidedlibrariesrequirethefullyqualifieddatasetnamesofthelibrariesbeincludedintheLIBparameter.

11.17LOGOFFTheLOGOFFcommandisusedtoterminatetheTSOsession.YoumustexitISPFbeforeyoucanusetheLOGOFFcommand.

LogofffromthecurrentTSOsession:LOGOFF

11.18LOGONTheLOGONcommandisusedtoterminatethecurrentTSOsessionandbeginanother

one,typicallywithadifferentuserid.YoumustexitISPFbeforeyoucanusetheLOGONcommand.

Logofffromthecurrentsessionandlogontoanewsession:LOGON[userid]

MVS-38-TSO


76/84


77/84

FundamentalsofTSO

11.19PROFILEPROFILEisusedtoestablishvarioussettingsforyourTSOsessions.Inparticular,youcanchangeyourPREFIXsetting,whichhasaninitialvalueofyouruserideachtimeyoulogon.

ChangethePREFIXtoanothervalue:PROFILEPREFIX(ABCDE)

DisablethePREFIX;alldatasetnamesmustbefullyqualified:PROFILENOPREFIX

DisplaythecurrentPROFILEsettings:PROFILELIST

Turnmessageidentifierson/offfordiagnosticmessages:

PROFILEMSGID

PROFILENOMSGID

11.20RECEIVETheRECEIVEcommandisusedtoreceivefilessentfromanotheruserandrestorethemtodisk.TheTRANSMITcommandisusedtosendafiletoanotheruser.RECEIVEshouldbespecifiedwithoutanyoptions.

TheRECEIVEcommand(withnooptions)promptsyouforeachfiletobereceived.(Youhavenocontrolovertheorderinwhichthefilesarereceived.)Therearethreepossibleresponsestotheprompt:DELETE,todeletethecurrentfile;END,tote

rminatetheRECEIVEcommand);andRESTOREwithoptionalparameterstoreceivethefile.(RESTOREisthedefaultandmaybeomitted.)

Ifyoureceivethefilewithoutprovidinganewname,thefileisgiventhesamenameastheoriginalbutwiththefirstqualifierreplacedwithyouruserid.Tosavethefilewithadifferentname,useDSN(filename)asoneoftheoptionalparameters.

UsetheTSOHelpcommandforfurtherinformation:HELPRECEIVE.(OnanISPFcommandline,useTSOHELPRECEIVE.)

Alogfilenameduserid.LOG.MISCiswrittencontainingasummaryofthefilesreceivedortransmitted.Thespaceforthisfilecomesoutofyourdiskquota,soyoushouldperiodicallydeleteit.

MVS-39-TSO


78/84

FundamentalsofTSO

11.21RENAMERENAMEisusedtorenamedatasetsormembersofdatasets.ISPFalsohasseveralrenamefacilities.Ifadatasetisprotectedbyobsoletefeatures,suchastheNOPWREADsetting,theTSORENAMEcommandshouldbeused.

Renameadataset:RENAMEoldnamenewname

Renameamember:RENAMEdataset(oldmembername)dataset(newmembername)

11.22SENDSENDisusedtosendamessagetoanotheruserontheMVSsystem.Sendamessagetoseveraluserids:SEND'texttobesent'USER(userid1userid2etc.)

11.23SUBMIT

SUBMITisusedtosubmitbatchjobsforprocessing.ThiscommandisdiscussedintheBATCHJOBSUBMITTALsectionofthiswrite-up.

Submitabatchjob:

SUBMITdsname/*TSOcommand*/

SUBMIT(dsnamedsname...)/*TSOcommand*/

SUBMIT/*SPF/PDFeditorcommand*/

11.24TRANSMIT

TheTRANSMITcommandisusedtosendfilestoanotheruser.TheRECEIVEcommandisusedtoreceivefilessentfromanotheruserandrestorethemtodisk.(ASU'sVM/CMSsystemhasalocallydevelopedutility,MVSSEND,whichcantransmitafiletotheAcademicMVSsystem.ThesyntaxforMVSSENDissimilartotheSENDFILEcommand.DoNOTusetheSENDFILEcommand.)

Thefollowingcommandsillustratehowtotransmitanentirepartitioneddataset,asinglememberofapartitioneddataset,andasequentialdataset.(ThenodenameoftheacademicMVSsystemisACADMVS.)

TRANSMITnode.useridDSN(pds.data.set)/*entirePDS*/TRANSMITnode.useridDSN(pds.data.set(member))SEQ/*onemember*/TRANSMITnode.useridDSN(seq.data.set)SEQ/*sequential*/

MVS-40-TSO


79/84

FundamentalsofTSO

UsetheTSOHelpcommandforfurtherinformation:HELPTRANSMIT.(OnanISPFcommandline,useTSOHELPTRANSMIT.)

Alogfilenameduserid.LOG.MISCiswrittencontainingasummaryofthefilesreceivedortransmitted.Thespaceforthisfilecomesoutofyourdiskquota,soyoushouldperiodicallydeleteit.

11.25UNPRESSUNPRESSisusedtodecompressWYLBUReditformatdatasets.UNPRESShasonerequiredpositionalparameter(thenameofthedatasettobedecompressed)andanoptionalDSNAMEkeywordparameter(thenameoftheoutputdataset).Iftheoutputdatasetnameisomitted(recommended),theoriginaldatasetisreplacedwithadecompressed,variableformatdataset.

UsetheDSNAMEoptiononlyifyouwanttoretaintheoriginaldatasetorifyouwantthedecompresseddatasettobeinfixedformat.Inthissituation,theoutputd

atasetmustexistbeforeyouexecuteUNPRESS;i.e.,youneedtocreateanemptyoutputdataset(withanamedifferentthantheinputdataset)oftheappropriatesizeandformatbeforeexecutingUNPRESS.

UNPRESScanbeenteredonacommandline,butismostoftenusedonanISPF3.4datasetlistpanel.Onadatasetlistpanel,youtabtothelinecontainingthedatasetnameofinterestandtype%UNPRESStotheleftofthedatasetname.Thedatasetnameisassumedasthefirstpositionalparameter,i.e.,youdon'thaveto(and

mustnot)typetheinputdatasetname.

(UNPRESSisactuallyanexecwrittenintheREXXlanguage.Assuch,thecommandisusuallytypedas%UNPRESSforefficiencyreasons.)

DecompressaWYLBURdataset:

%UNPRESSinputdsn/*Decompressinplace*/

%UNPRESSinputdsnDSNAME(outputdsn)/*Decompressintoanother*/

12.MISCELLANEOUS12.1InteractiveProgramExecutionInteractionexecutionvariesbysoftwareproduct.Thedocumentationforeachsoftwareproductprovidesthenecessaryinformation.Ingeneral,softwareisaccessedviaISPFpanelsorsystemprovidedexecs.SomesoftwaremayrequireadditionalALLOCstatementsbeforebeingused,whileothersmayrequireuseoftheCALLstatement.Forexample,SASisinvokedbyasinglecommand,whichisanexecthatinternallyco


80/84

ntainsmanyALLOCstatementsandaCALLstatement.ItisrarelynecessarytoenteranyothercommandstobeginusingSAS.

MVS-41-TSO


81/84

FundamentalsofTSO

Forsomeprograms,suchasthosewritteninFORTRAN,itisnecessarytocompiletheprogram,(maybe)linkit,andthenexecuteit.Forexample,aFORTRANprogrammaybecompiledandlinkedfromISPFoption4andlaterexecutedviatheCALLstatement.Alternatively,youcanbypassISPFandthesystemexecsentirelybyenteringthevariousALLOCandCALLstatementsyourself,thoughyouwouldneedtorefertothereferencemanualstodeterminewhatstatementsareneeded.

Youcancreateexecstoautomaticallyexecutecertaincommands,buildaneditmacro,orexecuteoneofyourownprograms.Typically,theexecwouldcontaineditor,ISPF,orTSOcommandswithsomeadditionalcontrolstatements(e.g.,REXXcontrolstatements).

12.2TechnicalDetailsThelogonprocedureusedbymostpeopleisISPFPDFS,whichisamemberinthe

partitioneddataset'SYS1.PROCLIB'.ISPFPDFSdefinesnumerousddnames.Ifyouwanttoaddyourownlibrariestoanyofthepre-allocatedddnames,besuretoincludetheexistinglibrarieswhenreallocatingtheddnames.

TheddnamesSTEPLIBandISPLLIBdefineloadmodulelibrariesforbinaryexecutableprograms,butonlyISPLLIBmaybealteredduringaTSOsession.Forexample,ifyouputsoftwareonthesystemwhichrequiresaloadmodulelibrary,youcouldreallocatetheISPLLIBddname(whileISPFisnotactive)todefineadditionalruntimelibraries.

ThusyoucouldsubsequentlyinvokethesoftwarefromwithintheISPFenvironment.

Otherddnamesandtheirusesare:SYSPROCforCLISTandREXXexecs(interpretedprograms);SYSEXECforREXXexecsonly;ISPPLIBforpanels(menus);ISPMLIBformessages;ISPSLIBforskeletons(editortemplates);ISPTLIBfortables;andISPTABLforoutputtables.(TheISPxxxxddnamescanberedefinedbutmustbedonewhileISPFisnotactive.)

Usingtheseddnames,youcancreateyourownpanels,execs,editmacros(whichare

usuallyCLISTorREXXexecs),etc.YoucancustomizeyourTSOand/orISPFsessionsaccordingtoyourneeds.

Othermethodsexistsfordefiningddnameswhichprovidethesamefunctionasthosedescribedabove.Refertovendordocumentationforinformationonthisandothermethodsofdefiningrun-timelibraries.


82/84

12.3LocalHelpandSampleCodeInadditiontovendorprovidedonlinehelp,otherlocallydevelopedhelpfilesandcodesamplesareavailableforusewiththeMVSsystem.

MVS-42-TSO


83/84

FundamentalsofTSO

Thelocallydevelopedhelpfilesareavailableviaawebbrowser(suchasNetscapeorInternetExplorer).TheURLforthehelpfilesishttp://www.asu.edu/it/fyi/mvs/.

Codesamplesforcommondisk/tapeutilityprogramareavailableduringaTSOISPFeditingsession.Followthestepsoutlinedbelowtoaccessthecodesamples.

??Begineditingthefileintowhichthecodesampleistobeinserted.??TypetheeditingcommandMODELCLASSJCLontheeditorcommandlineandpressEnter.Thisidentifieswhichsetofsamplecodetouse.

??TypetheeditingcommandMODELontheeditorcommandline,andtypeanAorBinalinenumberfield(toindicatewherethesamplecodeistobeinserted)andpressEnter.

??SelectfromthedisplayedmenuwhetheryouwantDiskorTapesamples,andpressEnter.

??Selectfromthedisplayedmenuwhichsamplecodetouse,andpressEnter.

(Therearemorecodesamplesthancanbedisplayedonasinglemenu.PressPF7orPF8toseeothermenupages.)

ThesamplecodeincludescommentstoindicatewhatJCLmodificationsshouldbemadebeforethecodeissubmittedforexecution.

MVS-43-TSO


84/84

Fundamentals of TSO

Documents

Transcript of Fundamentals of TSO