Regarding Universe Documentation

[dstest]

Hi,

Can any one please tell me where can i found the documentaion for the following basic functions.

DSR.SUB.JOB.RESERVE
Call @SUBR(Key, Arg2)
Call DSD.Init(MyJobNo, Dummy2)
Key = DSR.SUB.JOB.COMPILE


Appreciate for your help

[ray.wurlod]

Any routine with a DSD or DSR name is part of DataStage server engine. Source code is intellectual property of IBM (and heavily guarded) and there is no documentation in the public domain.

The Call @SUBR(args) form is documented in the DataStage BASIC manual. Search for "indirect call" in the section on the CALL statement.

"Key = DSR.SUB.JOB.COMPILE" is a simple assignment statement (that is, it is not a "basic function". The constant is declared in the header file for "helper subroutines", namely DSR_UVCONST.H in the DSINCLUDE directory.

[chulett]

Looks like KBA code.

To whit, a snippet from the Batch::UTILCompileJobs job:

Code: Select all

CompileJob:
      Key = DSR.SUB.JOB.RESERVE
      Arg2 = JobName
      Call @SUBR(Key, Arg2)
      Call DSD.Init(MyJobNo, Dummy2)
      If Key <> "" Then
         JobsNotCompiled<-1> = JobName:"   ":"Cannot attach to job"
         NumFailed += 1
      End Else
         Key = DSR.SUB.JOB.COMPILE
         Arg2 = JobName
         Call @SUBR(Key, Arg2)
         Call DSD.Init(MyJobNo, Dummy2)
         If Key <> "" Or Arg2<1> <> "" Then
            JobsNotCompiled<-1> = JobName:"   ":"Cannot compile job"
            NumFailed += 1
         End Else

I happily use it without necessarily understand what each line is doing.

[ray.wurlod]

You can "sort of" figure out what's going on by reading the comments in the header file, but you'll never be sure that you've got all the possibilities.