fix: adding outds and parameters to mv_jobexecute

chore: doxygen updates
2026-01-03 07:40:04 +00:00 · 2020-11-29 21:55:21 +01:00 · 2020-11-29 21:06:39 +01:00
5 changed files with 88 additions and 32 deletions
--- a/all.sas
+++ b/all.sas
@@ -12299,6 +12299,12 @@ libname &libref1 clear;
        ,name=somejob
      )

+  Example with parameters:
+
+     %mv_jobexecute(path=/Public/folder
+        ,name=somejob
+        ,paramstring=%str("macvarname":"macvarvalue","answer":42)
+      )

  @param access_token_var= The global macro variable to contain the access token
  @param grant_type= valid values:
@@ -12310,10 +12316,14 @@ libname &libref1 clear;

  @param path= The SAS Drive path to the job being executed
  @param name= The name of the job to execute
-  @param params= A macro quoted string to append to the URL
+  @param paramstring= A JSON fragment with name:value pairs, eg: `"name":"value"`
+  or "name":"value","name2":42`.  This will need to be wrapped in `%str()`.
+
  @param contextName= Context name with which to run the job.
    Default = `SAS Job Execution compute context`

+  @param outds= The output dataset containing links (Default=work.mv_jobexecute)
+

  @version VIYA V.03.04
  @author Allan Bowe, source: https://github.com/sasjs/core
@@ -12322,6 +12332,7 @@ libname &libref1 clear;
  @li mp_abort.sas
  @li mf_getplatform.sas
  @li mf_getuniquefileref.sas
+  @li mf_getuniquelibref.sas
  @li mv_getfoldermembers.sas

 **/
@@ -12331,6 +12342,8 @@ libname &libref1 clear;
    ,contextName=SAS Job Execution compute context
    ,access_token_var=ACCESS_TOKEN
    ,grant_type=sas_services
+    ,paramstring=0
+    ,outds=work.mv_jobexecute
  );
 %local oauth_bearer;
 %if &grant_type=detect %then %do;
@@ -12392,11 +12405,16 @@ run;

 data _null_;
  file &fname0;
-  put '{"jobDefinitionUri": "'@@;
-  put "&joburi"@@;
-  put '","arguments":{"_contextName":"'@@;
-  put "&contextName"@@;
-  put '"}}';
+  length joburi contextname $128 paramstring $32765;
+  joburi=quote(trim(symget('joburi')));
+  contextname=quote(trim(symget('contextname')));
+  paramstring=symget('paramstring');
+  put '{"jobDefinitionUri":' joburi ;
+  put '  ,"arguments":{"_contextName":' contextname;
+  if paramstring ne "0" then do;
+    put '    ,' paramstring;
+  end;
+  put '}}';
 run;

 proc http method='POST' in=&fname0 out=&fname1 &oauth_bearer
@@ -12408,18 +12426,27 @@ proc http method='POST' in=&fname0 out=&fname1 &oauth_bearer
  %end;
  ;
 run;
-/*data _null_;infile &fname1;input;putlog _infile_;run;*/
-
-%mp_abort(iftrue=(
-    &SYS_PROCHTTP_STATUS_CODE ne 200 and &SYS_PROCHTTP_STATUS_CODE ne 201
+%if &SYS_PROCHTTP_STATUS_CODE ne 200 and &SYS_PROCHTTP_STATUS_CODE ne 201 %then
+%do;
+  data _null_;infile &fname0;input;putlog _infile_;run;
+  data _null_;infile &fname1;input;putlog _infile_;run;
+  %mp_abort(mac=&sysmacroname
+    ,msg=%str(&SYS_PROCHTTP_STATUS_CODE &SYS_PROCHTTP_STATUS_PHRASE)
  )
-  ,mac=&sysmacroname
-  ,msg=%str(&SYS_PROCHTTP_STATUS_CODE &SYS_PROCHTTP_STATUS_PHRASE)
-)
+%end;
+
+%local libref;
+%let libref=%mf_getuniquelibref();
+libname &libref JSON fileref=&fname1;
+
+data &outds;
+  set &libref..links;
+run;

 /* clear refs */
 filename &fname0 clear;
 filename &fname1 clear;
+libname &libref;

 %mend;/**
  @file mv_registerclient.sas
--- a/doxy/Doxyfile
+++ b/doxy/Doxyfile
@@ -24,7 +24,7 @@ LAYOUT_FILE            = ./doxy/DoxygenLayout.xml
 MAX_INITIALIZER_LINES  = 0
 PROJECT_NAME           = Macro Core
 PROJECT_LOGO           = doxy/Macro_core_website_1.png
-PROJECT_BRIEF          = placeholder
+PROJECT_BRIEF          = "Production Ready Macros for SAS Application Developers"
 RECURSIVE              = YES
 REPEAT_BRIEF           = NO
 SHOW_NAMESPACES        = NO
--- a/doxy/build.sh
+++ b/doxy/build.sh
@@ -33,11 +33,11 @@ cd core.github.io
 rm -r *
 mv $BUILD_FOLDER/out/doxy/* .
 echo 'core.sasjs.io' > CNAME
-git add *
+git add .
 git commit -m "build.sh build on $(date +%F:%H:%M:%S)"
 git push
 npx sitemap-generator-cli https://core.sasjs.io
-git add *
+git add .
 git commit -m "adding sitemap"
 git push

--- a/doxy/new_header.html
+++ b/doxy/new_header.html
@@ -1,6 +1,6 @@
-<!-- HTML header for doxygen 1.8.17-->
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
+<!-- HTML header for doxygen 1.8.17-->
+<html xmlns="https://www.w3.org/1999/xhtml" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
 <meta http-equiv="X-UA-Compatible" content="IE=9"/>
@@ -41,7 +41,9 @@ $extrastylesheet
        https://github.com/sasjs/core
    </a>

-   </div><!--END PROJECT_BRIEF-->
+   </div>
+   <meta name="Description" content="$projectbrief">
+   <!--END PROJECT_BRIEF-->
  </td>
  <!--END PROJECT_NAME-->
  <!--BEGIN !PROJECT_NAME-->
--- a/viya/mv_jobexecute.sas
+++ b/viya/mv_jobexecute.sas
@@ -16,6 +16,12 @@
        ,name=somejob
      )

+  Example with parameters:
+
+     %mv_jobexecute(path=/Public/folder
+        ,name=somejob
+        ,paramstring=%str("macvarname":"macvarvalue","answer":42)
+      )

  @param access_token_var= The global macro variable to contain the access token
  @param grant_type= valid values:
@@ -27,10 +33,14 @@

  @param path= The SAS Drive path to the job being executed
  @param name= The name of the job to execute
-  @param params= A macro quoted string to append to the URL
+  @param paramstring= A JSON fragment with name:value pairs, eg: `"name":"value"`
+  or "name":"value","name2":42`.  This will need to be wrapped in `%str()`.
+
  @param contextName= Context name with which to run the job.
    Default = `SAS Job Execution compute context`

+  @param outds= The output dataset containing links (Default=work.mv_jobexecute)
+

  @version VIYA V.03.04
  @author Allan Bowe, source: https://github.com/sasjs/core
@@ -39,6 +49,7 @@
  @li mp_abort.sas
  @li mf_getplatform.sas
  @li mf_getuniquefileref.sas
+  @li mf_getuniquelibref.sas
  @li mv_getfoldermembers.sas

 **/
@@ -48,6 +59,8 @@
    ,contextName=SAS Job Execution compute context
    ,access_token_var=ACCESS_TOKEN
    ,grant_type=sas_services
+    ,paramstring=0
+    ,outds=work.mv_jobexecute
  );
 %local oauth_bearer;
 %if &grant_type=detect %then %do;
@@ -109,11 +122,16 @@ run;

 data _null_;
  file &fname0;
-  put '{"jobDefinitionUri": "'@@;
-  put "&joburi"@@;
-  put '","arguments":{"_contextName":"'@@;
-  put "&contextName"@@;
-  put '"}}';
+  length joburi contextname $128 paramstring $32765;
+  joburi=quote(trim(symget('joburi')));
+  contextname=quote(trim(symget('contextname')));
+  paramstring=symget('paramstring');
+  put '{"jobDefinitionUri":' joburi ;
+  put '  ,"arguments":{"_contextName":' contextname;
+  if paramstring ne "0" then do;
+    put '    ,' paramstring;
+  end;
+  put '}}';
 run;

 proc http method='POST' in=&fname0 out=&fname1 &oauth_bearer
@@ -125,17 +143,26 @@ proc http method='POST' in=&fname0 out=&fname1 &oauth_bearer
  %end;
  ;
 run;
-/*data _null_;infile &fname1;input;putlog _infile_;run;*/
-
-%mp_abort(iftrue=(
-    &SYS_PROCHTTP_STATUS_CODE ne 200 and &SYS_PROCHTTP_STATUS_CODE ne 201
+%if &SYS_PROCHTTP_STATUS_CODE ne 200 and &SYS_PROCHTTP_STATUS_CODE ne 201 %then
+%do;
+  data _null_;infile &fname0;input;putlog _infile_;run;
+  data _null_;infile &fname1;input;putlog _infile_;run;
+  %mp_abort(mac=&sysmacroname
+    ,msg=%str(&SYS_PROCHTTP_STATUS_CODE &SYS_PROCHTTP_STATUS_PHRASE)
  )
-  ,mac=&sysmacroname
-  ,msg=%str(&SYS_PROCHTTP_STATUS_CODE &SYS_PROCHTTP_STATUS_PHRASE)
-)
+%end;
+
+%local libref;
+%let libref=%mf_getuniquelibref();
+libname &libref JSON fileref=&fname1;
+
+data &outds;
+  set &libref..links;
+run;

 /* clear refs */
 filename &fname0 clear;
 filename &fname1 clear;
+libname &libref;

 %mend;
Author	SHA1	Message	Date
Allan Bowe	def0cc8476	fix: adding outds and parameters to mv_jobexecute	2020-11-29 21:55:21 +01:00
Allan Bowe	3a9029557e	chore: doxygen updates	2020-11-29 21:06:39 +01:00